DataKey 클래스

정의

데이터 바인딩된 컨트롤에서 기본 키 필드 또는 레코드의 필드를 나타냅니다.Represents the primary key field or fields of a record in a data-bound control.

public ref class DataKey : System::Web::UI::IStateManager
public ref class DataKey : IEquatable<System::Web::UI::WebControls::DataKey ^>, System::Web::UI::IStateManager
public class DataKey : System.Web.UI.IStateManager
public class DataKey : IEquatable<System.Web.UI.WebControls.DataKey>, System.Web.UI.IStateManager
type DataKey = class
    interface IStateManager
type DataKey = class
    interface IStateManager
    interface IEquatable<DataKey>
Public Class DataKey
Implements IStateManager
Public Class DataKey
Implements IEquatable(Of DataKey), IStateManager
상속
DataKey
구현

예제

다음 코드 예제에는 레코드의 기본 키 값을 확인 하는 방법을 보여 줍니다.를 DetailsView 사용 하 여 제어 합니다 Value 의 속성을 DataKey 개체.The following code example demonstrates how to determine the primary key value of a record in a DetailsView control using the Value property of a DataKey object.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomerDetailsView_DataBound(Object sender, EventArgs e)
  {
    // Get the DataKey object for the current record.
    DataKey key = CustomerDetailsView.DataKey;
    
    // Display the value of the key field.
    MessageLabel.Text = "The key field value for the displayed record is " + 
      key.Value.ToString() + ".";
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

  <head runat="server">
    <title>DataKey Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DataKey Example</h3>
                       
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          autogeneraterows="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          ondatabound="CustomerDetailsView_DataBound" 
          runat="server">
            
        </asp:detailsview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub CustomerDetailsView_DataBound(ByVal sender As Object, ByVal e As EventArgs) Handles CustomerDetailsView.DataBound

    ' Get the DataKey object for the current record.
    Dim key As DataKey = CustomerDetailsView.DataKey
    
    ' Display the value of the key field.
    MessageLabel.Text = "The key field value for the displayed record is " & _
      key.Value.ToString() & "."
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

  <head runat="server">
    <title>DataKey Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DataKey Example</h3>
                       
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          autogeneraterows="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
            
        </asp:detailsview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

설명

DataKey 클래스는 데이터 바인딩된 컨트롤에서 레코드에 대 한 기본 키를 나타내는 데 사용 됩니다.The DataKey class is used to represent the primary key for a record in a data-bound control. 데이터 원본에서 더 많은 필드 중 하나의 레코드에 대 한 기본 키를 구성할 수 있습니다.The primary key for a record can be composed of one of more fields from the data source. 하지만 DataKey 클래스 컬렉션이 아닙니다., 여러 키 필드 값을 저장할 수 있습니다.Although the DataKey class is not a collection, it can store multiple key field values. 경우 키 필드의 값은 채워집니다에 대 한 생성자는 DataKey 클래스 라고 합니다.The key field values are populated when one of the constructors for the DataKey class is called. 키 필드 값을 검색할 수는 DataKey 다음과 같은 방법으로 개체:You can retrieve a key field value from a DataKey object in the following ways:

  • 사용 하 여는 DataKey.Item[Int32] 특정 인덱스에 있는 키 필드 값을 검색 하는 속성을 DataKey 개체입니다.Use the DataKey.Item[Int32] property to retrieve a key field value at a specific index in the DataKey object.

  • 사용 된 DataKey.Item[String] 특정 필드의 키 필드 값을 검색 하는 속성입니다.Use the DataKey.Item[String] property to retrieve a key field value of a specific field.

  • 사용 합니다 Value 인덱스 0에 있는 키 필드의 값을 검색 하는 속성을 DataKey 개체입니다.Use the Value property to retrieve the value of the key field at index 0 in the DataKey object. 이 속성은 종종 기본 키 필드 하나만 포함 하는 경우 레코드의 키 값을 검색 하려면 바로 가기로 사용 됩니다.This property is often used as a shortcut to retrieve the key value of a record when the primary key contains only one field.

  • 사용 합니다 Values 만들 속성을 IOrderedDictionary 키 필드 값을 반복 하는 데 사용할 수 있습니다.Use the Values property to create an IOrderedDictionary object that can be used to iterate through the key field values.

일반적으로 DataKey 개체는 데이터 바인딩된에서 자동으로 생성 시점을 제어 컨트롤의 DataKeyNames 속성을 설정 합니다.In general, DataKey objects are automatically generated by data-bound controls when the control's DataKeyNames property is set. 합니다 DataKey 필드에 지정 된 키 필드의 값을 포함 하는 개체는 DataKeyNames 속성입니다.The DataKey objects contain the values of the key field or fields specified in the DataKeyNames property. 한 번에 단일 레코드를 표시 하는 데이터 바인딩된 컨트롤 (같은 DetailsView 또는 FormView) 일반적으로 저장 합니다 DataKey 에 표시 되는 현재 레코드에 대 한 개체는 DataKey 컨트롤의 속성입니다.Data-bound controls that display a single record at a time (such as DetailsView or FormView) generally store the DataKey object for the current record displayed in the DataKey property of the control. 한 번에 여러 레코드를 표시 하는 데이터 바인딩된 컨트롤 (같은 GridView) 일반적으로 저장 합니다 DataKey 컨트롤의 각 레코드에 대 한 개체를 DataKeyArray 컬렉션입니다.Data-bound controls that display multiple records at a time (such as GridView) generally store the DataKey objects for each record in the control in a DataKeyArray collection. 합니다 DataKeyArray 컬렉션에 저장 되는 DataKeys 컨트롤의 속성입니다.The DataKeyArray collection is then stored in the DataKeys property of the control.

생성자

DataKey(IOrderedDictionary)

지정된 키 필드 값 사전을 사용하여 DataKey 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataKey class using the specified dictionary of key field values.

DataKey(IOrderedDictionary, String[])

지정된 키 필드 값 사전과 필드 이름 배열을 사용하여 DataKey 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataKey class using the specified dictionary of key field values and array of field names.

속성

IsTrackingViewState

DataKey 개체에서 해당 뷰 상태의 변경 사항을 추적하는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the DataKey object is tracking its view-state changes.

Item[Int32]

DataKey 개체에서 지정된 인덱스에 있는 키 필드의 값을 가져옵니다.Gets the value of the key field at the specified index from a DataKey object.

Item[String]

DataKey 개체에서 지정된 필드 이름을 갖는 키 필드의 값을 가져옵니다.Gets the value of the key field with the specified field name from a DataKey object.

Value

DataKey 개체에서 인덱스 0에 있는 키 필드의 값을 가져옵니다.Gets the value of the key field at index 0 in the DataKey object.

Values

IOrderedDictionary 개체의 모든 키 필드가 들어 있는 DataKey 개체를 가져옵니다.Gets an IOrderedDictionary object that contains every key field in the DataKey object.

메서드

Equals(DataKey)

지정된 DataKey 배열이 현재 데이터 키와 같은지 여부를 확인합니다.Determines whether the specified DataKey array is equal to the current data key.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
LoadViewState(Object)

이전에 저장된 DataKey 개체의 뷰 상태를 로드합니다.Loads the previously saved view state of the DataKey object.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
SaveViewState()

DataKey 개체의 현재 뷰 상태를 저장합니다.Saves the current view state of the DataKey object.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
TrackViewState()

뷰 상태의 변경 사항을 추적하여 DataKey 개체에 이 변경 사항을 저장할 시작 위치를 표시합니다.Marks the starting point at which to begin tracking and saving view-state changes to the DataKey object.

명시적 인터페이스 구현

IStateManager.IsTrackingViewState

DataKey 개체에서 해당 뷰 상태의 변경 사항을 추적하는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the DataKey object is tracking its view-state changes.

IStateManager.LoadViewState(Object)

이전에 저장된 DataKey 개체의 뷰 상태를 로드합니다.Loads the previously saved view state of the DataKey object.

IStateManager.SaveViewState()

DataKey 개체의 현재 뷰 상태를 저장합니다.Saves the current view state of the DataKey object.

IStateManager.TrackViewState()

뷰 상태의 변경 사항을 추적하여 DataKey 개체에 이 변경 사항을 저장할 시작 위치를 표시합니다.Marks the starting point at which to begin tracking and saving view-state changes to the DataKey object.

적용 대상

추가 정보