DataKey 클래스

참조

정의

네임스페이스:: System.Web.UI.WebControls

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

데이터 바인딩된 컨트롤에서 기본 키 필드 또는 레코드의 필드를 나타냅니다.

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

상속: Object
DataKey

구현: IStateManager IEquatable<DataKey>

예제

다음 코드 예제에는 레코드의 기본 키 값을 확인 하는 방법을 보여 줍니다.를 DetailsView 사용 하 여 제어 합니다 Value 의 속성을 DataKey 개체.


<%@ 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 클래스는 데이터 바인딩된 컨트롤에서 레코드에 대 한 기본 키를 나타내는 데 사용 됩니다. 데이터 원본에서 더 많은 필드 중 하나의 레코드에 대 한 기본 키를 구성할 수 있습니다. 하지만 DataKey 클래스 컬렉션이 아닙니다., 여러 키 필드 값을 저장할 수 있습니다. 경우 키 필드의 값은 채워집니다에 대 한 생성자는 DataKey 클래스 라고 합니다. 키 필드 값을 검색할 수는 DataKey 다음과 같은 방법으로 개체:

사용 하 여는 DataKey.Item[Int32] 특정 인덱스에 있는 키 필드 값을 검색 하는 속성을 DataKey 개체입니다.
사용 된 DataKey.Item[String] 특정 필드의 키 필드 값을 검색 하는 속성입니다.
사용 합니다 Value 인덱스 0에 있는 키 필드의 값을 검색 하는 속성을 DataKey 개체입니다. 이 속성은 종종 기본 키 필드 하나만 포함 하는 경우 레코드의 키 값을 검색 하려면 바로 가기로 사용 됩니다.
사용 합니다 Values 만들 속성을 IOrderedDictionary 키 필드 값을 반복 하는 데 사용할 수 있습니다.

일반적으로 DataKey 개체는 데이터 바인딩된에서 자동으로 생성 시점을 제어 컨트롤의 DataKeyNames 속성을 설정 합니다. 합니다 DataKey 필드에 지정 된 키 필드의 값을 포함 하는 개체는 DataKeyNames 속성입니다. 한 번에 단일 레코드를 표시 하는 데이터 바인딩된 컨트롤 (같은 DetailsView 또는 FormView) 일반적으로 저장 합니다 DataKey 에 표시 되는 현재 레코드에 대 한 개체는 DataKey 컨트롤의 속성입니다. 한 번에 여러 레코드를 표시 하는 데이터 바인딩된 컨트롤 (같은 GridView) 일반적으로 저장 합니다 DataKey 컨트롤의 각 레코드에 대 한 개체를 DataKeyArray 컬렉션입니다. 합니다 DataKeyArray 컬렉션에 저장 되는 DataKeys 컨트롤의 속성입니다.

생성자

DataKey(IOrderedDictionary)	지정된 키 필드 값 사전을 사용하여 DataKey 클래스의 새 인스턴스를 초기화합니다.
DataKey(IOrderedDictionary, String[])	지정된 키 필드 값 사전과 필드 이름 배열을 사용하여 DataKey 클래스의 새 인스턴스를 초기화합니다.

속성

IsTrackingViewState	DataKey 개체에서 해당 뷰 상태의 변경 사항을 추적하는지 여부를 나타내는 값을 가져옵니다.
Item[Int32]	DataKey 개체에서 지정된 인덱스에 있는 키 필드의 값을 가져옵니다.
Item[String]	DataKey 개체에서 지정된 필드 이름을 갖는 키 필드의 값을 가져옵니다.
Value	DataKey 개체에서 인덱스 0에 있는 키 필드의 값을 가져옵니다.
Values	IOrderedDictionary 개체의 모든 키 필드가 들어 있는 DataKey 개체를 가져옵니다.

메서드

Equals(DataKey)	지정된 DataKey 배열이 현재 데이터 키와 같은지 여부를 확인합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
LoadViewState(Object)	이전에 저장된 DataKey 개체의 뷰 상태를 로드합니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
SaveViewState()	DataKey 개체의 현재 뷰 상태를 저장합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
TrackViewState()	뷰 상태의 변경 사항을 추적하여 DataKey 개체에 이 변경 사항을 저장할 시작 위치를 표시합니다.

명시적 인터페이스 구현

IStateManager.IsTrackingViewState	DataKey 개체에서 해당 뷰 상태의 변경 사항을 추적하는지 여부를 나타내는 값을 가져옵니다.
IStateManager.LoadViewState(Object)	이전에 저장된 DataKey 개체의 뷰 상태를 로드합니다.
IStateManager.SaveViewState()	DataKey 개체의 현재 뷰 상태를 저장합니다.
IStateManager.TrackViewState()	뷰 상태의 변경 사항을 추적하여 DataKey 개체에 이 변경 사항을 저장할 시작 위치를 표시합니다.

적용 대상

DataKey 클래스

정의

예제

설명

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

추가 리소스