Aracılığıyla paylaş

DataKey Sınıf

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Veriye bağlı denetimdeki bir kaydın birincil anahtar alanını veya alanlarını temsil eder.

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
Devralma
Object
DataKey
Uygulamalar
IStateManager IEquatable<DataKey>

Örnekler

Aşağıdaki kod örneği, bir nesnenin özelliğini DataKey kullanarak denetimdeki bir DetailsView kaydın Value birincil anahtar değerinin nasıl belirleneceğini gösterir.


<%@ 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>

Açıklamalar

DataKey sınıfı, veriye bağlı denetimdeki bir kaydın birincil anahtarını temsil etmek için kullanılır. Bir kaydın birincil anahtarı, veri kaynağındaki daha fazla alandan oluşabilir. DataKey Sınıfı bir koleksiyon olmasa da, birden çok anahtar alanı değerini depolayabilir. Sınıfın oluşturucularından DataKey biri çağrıldığında anahtar alan değerleri doldurulur. Bir nesneden DataKey anahtar alanı değerini aşağıdaki yollarla alabilirsiniz:

  • nesnesindeki DataKey.Item[Int32] belirli bir dizinde DataKey anahtar alan değeri almak için özelliğini kullanın.

  • DataKey.Item[String] Belirli bir alanın anahtar alanı değerini almak için özelliğini kullanın.

  • nesnesindeki Value 0 DataKey dizinindeki anahtar alanının değerini almak için özelliğini kullanın. Bu özellik genellikle birincil anahtar yalnızca bir alan içerdiğinde kaydın anahtar değerini almak için kısayol olarak kullanılır.

  • Values anahtar alanı değerleri arasında yinelemek için kullanılabilecek bir IOrderedDictionary nesne oluşturmak için özelliğini kullanın.

Genel olarak, DataKey denetimin özelliği ayarlandığında nesneler veriye bağlı denetimler DataKeyNames tarafından otomatik olarak oluşturulur. DataKey Nesneler, anahtar alanının veya özelliğinde DataKeyNames belirtilen alanların değerlerini içerir. Tek seferde tek bir kaydı görüntüleyen veriye bağlı denetimler (veya gibiDetailsView) genellikle denetimin özelliğinde görüntülenen geçerli kaydın DataKey nesnesini depolarDataKey.FormView Bir kerede birden çok kayıt görüntüleyen veriye bağlı denetimler (örneğinGridView), genellikle bir koleksiyondaki denetimdeki DataKeyArray her kayıt için nesneleri depolarDataKey. Koleksiyon DataKeyArray daha sonra denetimin DataKeys özelliğinde depolanır.

Oluşturucular

Name Description
DataKey(IOrderedDictionary, String[])

Anahtar alan değerlerinin DataKey belirtilen sözlüğünü ve alan adları dizisini kullanarak sınıfın yeni bir örneğini başlatır.
DataKey(IOrderedDictionary)

Anahtar alanı değerlerinin DataKey belirtilen sözlüğünü kullanarak sınıfın yeni bir örneğini başlatır.

Özellikler

Name Description
IsTrackingViewState

Nesnenin DataKey görünüm durumu değişikliklerini izlediğini belirten bir değer alır.
Item[Int32]

Belirtilen dizindeki anahtar alanının değerini bir DataKey nesneden alır.
Item[String]

Bir nesneden DataKey belirtilen alan adına sahip anahtar alanının değerini alır.
Value

Nesnedeki dizin 0'daki DataKey anahtar alanının değerini alır.
Values

Nesnedeki DataKey her anahtar alanını içeren bir IOrderedDictionary nesne alır.

Yöntemler

Name Description
Equals(DataKey)

Belirtilen DataKey dizinin geçerli veri anahtarına eşit olup olmadığını belirler.
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
LoadViewState(Object)

Nesnenin daha önce kaydedilmiş görünüm durumunu DataKey yükler.
MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
SaveViewState()

Nesnenin geçerli görünüm durumunu DataKey kaydeder.
ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)
TrackViewState()

Nesnedeki görünüm durumu değişikliklerini izlemeye ve kaydetmeye başlamak için DataKey başlangıç noktasını işaretler.

Belirtik Arabirim Kullanımları

Name Description
IStateManager.IsTrackingViewState

Nesnenin DataKey görünüm durumu değişikliklerini izlediğini belirten bir değer alır.
IStateManager.LoadViewState(Object)

Nesnenin daha önce kaydedilmiş görünüm durumunu DataKey yükler.
IStateManager.SaveViewState()

Nesnenin geçerli görünüm durumunu DataKey kaydeder.
IStateManager.TrackViewState()

Nesnedeki görünüm durumu değişikliklerini izlemeye ve kaydetmeye başlamak için DataKey başlangıç noktasını işaretler.

Şunlara uygulanır

Ayrıca bkz.