DataKey Sınıf

  • Başvuru

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 kullanarak Value bir denetimdeki kaydın DetailsView birincil anahtar değerinin DataKey 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. Sınıfı bir koleksiyon olmasa DataKey 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 dizin 0'daki DataKey anahtar alanının değerini almak için özelliğini kullanın. Bu özellik genellikle birincil anahtar tek 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 yineleme yapmak 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

DataKey(IOrderedDictionary)

Anahtar alanı değerlerinin DataKey belirtilen sözlüğünü kullanarak sınıfın yeni bir örneğini başlatır.
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.

Özellikler

IsTrackingViewState

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

Bir nesneden DataKey belirtilen dizindeki anahtar alanının değerini 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 nesnesi alır.

Yöntemler

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()

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

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

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

Geçerli Objectöğesinin sığ 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 dizeyi döndürür.

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

Nesnede 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ı

IStateManager.IsTrackingViewState

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

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

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

Nesnede 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.