ListView.DataKeys プロパティ

定義

DataKey コントロールの各項目のデータ キー値を表す 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

プロパティ値

ListView コントロールの各項目のデータ キーが格納されたオブジェクト。

属性

次の例は、使用する方法を示します、DataKeys内の項目のデータ キー値を決定するプロパティをListViewコントロール。 また、インデックスを使用する既定の動作ではなく、データ項目に基づいてユーザー選択を保持する方法も示します。

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

注釈

ときに、DataKeyNamesプロパティが設定されて、ListViewコントロールが自動的に作成、DataKeyコントロール内の各項目のオブジェクト。 DataKeyオブジェクトにはで指定されているフィールドの値が含まれています、DataKeyNamesプロパティ。 DataKey コントロールが使用するコントロールのコレクションに追加される DataKeys

使用して、DataKeysプロパティを取得する、DataKeyで特定のデータ項目のオブジェクト、ListViewコントロール。

プロパティを SelectedDataKey 使用すると、現在選択されている項目の DataKey オブジェクトを取得できます。 プロパティを SelectedValue 使用して、現在選択されている項目のデータ キー値を直接取得することもできます。

使用することができます、ListViewDataItem.DisplayIndexプロパティを取得する、DataKeyコマンド ボタンがクリックしてされた項目のオブジェクト。

適用対象

こちらもご覧ください