ListView.DataKeys Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient une collection d'objets DataKey qui représentent la valeur de clé de données pour chaque élément dans un contrôle ListView.

public:
 virtual property System::Web::UI::WebControls::DataKeyArray ^ DataKeys { System::Web::UI::WebControls::DataKeyArray ^ get(); };

[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.DataKeyArray DataKeys { get; }

[<System.ComponentModel.Browsable(false)>]
member this.DataKeys : System.Web.UI.WebControls.DataKeyArray

Public Overridable ReadOnly Property DataKeys As DataKeyArray

Valeur de propriété

DataKeyArray

Un objet qui contient la clé de données pour chaque élément dans un contrôle ListView.

Attributs: BrowsableAttribute

Exemples

L’exemple suivant montre comment utiliser la DataKeys propriété pour déterminer les valeurs de clé de données pour les éléments d’un ListView contrôle. Il montre également comment conserver la sélection de l’utilisateur en fonction d’un élément de données au lieu du comportement par défaut qui utilise l’index.

void ContactsListView_SelectedIndexChanged(Object sender, EventArgs e)
{
  if (ContactsListView.SelectedIndex >= 0)
    ViewState["SelectedKey"] = ContactsListView.SelectedValue;
  else
    ViewState["SelectedKey"] = null;
}

void ContactsListView_DataBound(Object sender, EventArgs e)
{
  for (int i = 0; i < ContactsListView.Items.Count; i++)
  {
    // Ignore values that cannot be cast as integer.
    try
    {
        if ((int)ContactsListView.DataKeys[i].Value == (int)ViewState["SelectedKey"])
            ContactsListView.SelectedIndex = i;
    }
    catch { }
  }
}

Sub ContactsListView_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
  If ContactsListView.SelectedIndex >= 0 Then
    ViewState("SelectedKey") = ContactsListView.SelectedValue
  Else
    ViewState("SelectedKey") = Nothing
  End If
End Sub

Sub ContactsListView_DataBound(ByVal sender As Object, ByVal e As EventArgs)
  For i As Integer = 0 To ContactsListView.Items.Count - 1
    ' Ignore values that cannot be cast as integer.
    Try
      If Convert.ToInt32(ContactsListView.DataKeys(i).Value) = Convert.ToInt32(ViewState("SelectedKey")) Then _
        ContactsListView.SelectedIndex = i
    Catch
    End Try
  Next
End Sub

Remarques

Lorsque la DataKeyNames propriété est définie, le ListView contrôle crée automatiquement un DataKey objet pour chaque élément du contrôle. L’objet DataKey contient les valeurs du champ ou des champs spécifiés dans la DataKeyNames propriété . Les DataKey objets sont ensuite ajoutés à la collection du DataKeys contrôle.

Utilisez la DataKeys propriété pour récupérer l’objet DataKey d’un élément de données spécifique dans le ListView contrôle.

Vous pouvez utiliser la SelectedDataKey propriété pour récupérer l’objet DataKey de l’élément actuellement sélectionné. Vous pouvez également utiliser la SelectedValue propriété pour récupérer directement la valeur de clé de données de l’élément actuellement sélectionné.

Vous pouvez utiliser la ListViewDataItem.DisplayIndex propriété pour récupérer l’objet DataKey de l’élément pour lequel un bouton de commande a été cliqué.

S’applique à

Partager via