ListView.DataKeys Properti

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.Extensions.dll

Mendapatkan kumpulan DataKey objek yang mewakili nilai kunci data untuk setiap item dalam ListView kontrol.

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

Nilai Properti

DataKeyArray

Objek yang berisi kunci data untuk setiap item dalam ListView kontrol.

Atribut

BrowsableAttribute

Contoh

Contoh berikut menunjukkan cara menggunakan DataKeys properti untuk menentukan nilai kunci data untuk item dalam ListView kontrol. Ini juga menunjukkan cara mempertahankan pilihan pengguna berdasarkan item data alih-alih perilaku default yang menggunakan indeks.

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

Keterangan

DataKeyNames Saat properti diatur, ListView kontrol secara otomatis membuat DataKey objek untuk setiap item dalam kontrol. Objek DataKey berisi nilai bidang atau bidang yang ditentukan dalam DataKeyNames properti . Objek DataKey kemudian ditambahkan ke koleksi kontrol DataKeys .

DataKeys Gunakan properti untuk mengambil DataKey objek untuk item data tertentu dalam ListView kontrol.

Anda dapat menggunakan SelectedDataKey properti untuk mengambil DataKey objek untuk item yang saat ini dipilih. Anda juga dapat menggunakan SelectedValue properti untuk mengambil nilai kunci data untuk item yang saat ini dipilih secara langsung.

Anda dapat menggunakan ListViewDataItem.DisplayIndex properti untuk mengambil DataKey objek untuk item yang tombol perintahnya diklik.

Lihat juga

• DataKey
• DataKeyArray
• DataKeyNames
• SelectedDataKey
• Kontrol Server Web ListView