DataKey Kelas

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili bidang kunci utama atau bidang rekaman dalam kontrol terikat data.

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

Warisan: Object
DataKey

Penerapan: IStateManager IEquatable<DataKey>

Contoh

Contoh kode berikut menunjukkan cara menentukan nilai kunci utama rekaman dalam DetailsView kontrol menggunakan Value properti DataKey objek.


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

Keterangan

Kelas DataKey digunakan untuk mewakili kunci primer untuk rekaman dalam kontrol terikat data. Kunci primer untuk rekaman dapat terdiri dari salah satu bidang lainnya dari sumber data. DataKey Meskipun kelas bukan koleksi, kelas dapat menyimpan beberapa nilai bidang kunci. Nilai bidang kunci diisi ketika salah satu konstruktor untuk kelas dipanggil DataKey . Anda dapat mengambil nilai bidang kunci dari DataKey objek dengan cara berikut:

DataKey.Item[Int32] Gunakan properti untuk mengambil nilai bidang kunci pada indeks tertentu dalam DataKey objek.
DataKey.Item[String] Gunakan properti untuk mengambil nilai bidang kunci dari bidang tertentu.
Value Gunakan properti untuk mengambil nilai bidang kunci pada indeks 0 dalam DataKey objek. Properti ini sering digunakan sebagai pintasan untuk mengambil nilai kunci rekaman saat kunci utama hanya berisi satu bidang.
Values Gunakan properti untuk membuat IOrderedDictionary objek yang dapat digunakan untuk melakukan iterasi melalui nilai bidang kunci.

Secara umum, DataKey objek secara otomatis dihasilkan oleh kontrol terikat data saat properti kontrol DataKeyNames diatur. Objek DataKey berisi nilai bidang kunci atau bidang yang ditentukan dalam DataKeyNames properti . Kontrol terikat data yang menampilkan satu rekaman sekaligus (seperti DetailsView atau FormView) umumnya menyimpan DataKey objek untuk rekaman saat ini yang ditampilkan di DataKey properti kontrol. Kontrol terikat data yang menampilkan beberapa rekaman sekaligus (seperti GridView) umumnya menyimpan DataKey objek untuk setiap rekaman dalam kontrol dalam DataKeyArray koleksi. Koleksi DataKeyArray kemudian disimpan di DataKeys properti kontrol.

Konstruktor

Nama	Deskripsi
DataKey(IOrderedDictionary, String[])	Menginisialisasi instans DataKey baru kelas menggunakan kamus nilai bidang kunci dan array nama bidang yang ditentukan.
DataKey(IOrderedDictionary)	Menginisialisasi instans DataKey baru kelas menggunakan kamus nilai bidang kunci yang ditentukan.

Properti

Nama	Deskripsi
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataKey objek melacak perubahan status tampilannya.
Item[Int32]	Mendapatkan nilai bidang kunci pada indeks yang ditentukan dari DataKey objek.
Item[String]	Mendapatkan nilai bidang kunci dengan nama bidang yang ditentukan dari DataKey objek.
Value	Mendapatkan nilai bidang kunci pada indeks 0 dalam DataKey objek.
Values	IOrderedDictionary Mendapatkan objek yang berisi setiap bidang kunci dalam DataKey objek.

Metode

Nama	Deskripsi
Equals(DataKey)	Menentukan apakah array yang ditentukan DataKey sama dengan kunci data saat ini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
LoadViewState(Object)	Memuat status tampilan objek yang DataKey disimpan sebelumnya.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
SaveViewState()	Menyimpan status DataKey tampilan objek saat ini.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TrackViewState()	Menandai titik awal untuk mulai melacak dan menyimpan perubahan status tampilan ke DataKey objek.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataKey objek melacak perubahan status tampilannya.
IStateManager.LoadViewState(Object)	Memuat status tampilan objek yang DataKey disimpan sebelumnya.
IStateManager.SaveViewState()	Menyimpan status DataKey tampilan objek saat ini.
IStateManager.TrackViewState()	Menandai titik awal untuk mulai melacak dan menyimpan perubahan status tampilan ke DataKey objek.

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?