DataKey DataKey DataKey DataKey Class

Definizione

Rappresenta il campo di chiave primaria oppure i campi di record in un controllo con associazione a dati.Represents the primary key field or fields of a record in a data-bound control.

public ref class DataKey : IEquatable<System::Web::UI::WebControls::DataKey ^>, System::Web::UI::IStateManager
public class DataKey : IEquatable<System.Web.UI.WebControls.DataKey>, System.Web.UI.IStateManager
type DataKey = class
    interface IStateManager
    interface IEquatable<DataKey>
Public Class DataKey
Implements IEquatable(Of DataKey), IStateManager
Ereditarietà
DataKeyDataKeyDataKeyDataKey
Implementazioni

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come determinare il valore di chiave primaria di DetailsView un record in Value un controllo utilizzando DataKey la proprietà di un oggetto.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>

Commenti

La DataKey classe viene utilizzata per rappresentare la chiave primaria per un record in un controllo con associazione a dati.The DataKey class is used to represent the primary key for a record in a data-bound control. La chiave primaria per un record può essere costituita da uno o più campi dall'origine dati.The primary key for a record can be composed of one of more fields from the data source. Sebbene la DataKey classe non sia una raccolta, può archiviare più valori di campo chiave.Although the DataKey class is not a collection, it can store multiple key field values. I valori dei campi chiave vengono popolati quando viene chiamato uno dei costruttori DataKey della classe.The key field values are populated when one of the constructors for the DataKey class is called. È possibile recuperare un valore di campo chiave da DataKey un oggetto nei modi seguenti:You can retrieve a key field value from a DataKey object in the following ways:

  • Utilizzare la DataKey.Item[Int32] proprietà per recuperare un valore di campo chiave in corrispondenza di un indice DataKey specifico nell'oggetto.Use the DataKey.Item[Int32] property to retrieve a key field value at a specific index in the DataKey object.

  • Utilizzare la DataKey.Item[String] proprietà per recuperare un valore di campo chiave di un campo specifico.Use the DataKey.Item[String] property to retrieve a key field value of a specific field.

  • Utilizzare la Value proprietà per recuperare il valore del campo chiave in corrispondenza dell'indice 0 DataKey nell'oggetto.Use the Value property to retrieve the value of the key field at index 0 in the DataKey object. Questa proprietà viene spesso utilizzata come collegamento per recuperare il valore della chiave di un record quando la chiave primaria contiene un solo campo.This property is often used as a shortcut to retrieve the key value of a record when the primary key contains only one field.

  • Utilizzare la Values proprietà per creare un IOrderedDictionary oggetto che può essere utilizzato per scorrere i valori dei campi chiave.Use the Values property to create an IOrderedDictionary object that can be used to iterate through the key field values.

In generale, DataKey gli oggetti vengono generati automaticamente dai controlli associati a dati quando viene impostata DataKeyNames la proprietà del controllo.In general, DataKey objects are automatically generated by data-bound controls when the control's DataKeyNames property is set. Gli DataKey oggetti contengono i valori del campo o dei campi chiave specificati DataKeyNames nella proprietà.The DataKey objects contain the values of the key field or fields specified in the DataKeyNames property. I controlli associati a dati che visualizzano un singolo record alla volta, ad DetailsView esempio FormViewo, archiviano DataKey in genere l' DataKey oggetto per il record corrente visualizzato nella proprietà del controllo.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. I controlli associati a dati che visualizzano più record alla volta (ad GridViewesempio) archiviano DataKey in genere gli oggetti per ogni record nel controllo DataKeyArray in una raccolta.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. La DataKeyArray raccolta viene quindi archiviata DataKeys nella proprietà del controllo.The DataKeyArray collection is then stored in the DataKeys property of the control.

Costruttori

DataKey(IOrderedDictionary) DataKey(IOrderedDictionary) DataKey(IOrderedDictionary) DataKey(IOrderedDictionary)

Inizializza una nuova istanza della classe DataKey utilizzando il dizionario specificato dei valori di campo di chiave.Initializes a new instance of the DataKey class using the specified dictionary of key field values.

DataKey(IOrderedDictionary, String[]) DataKey(IOrderedDictionary, String[]) DataKey(IOrderedDictionary, String[]) DataKey(IOrderedDictionary, String[])

Inizializza una nuova istanza della classe DataKey utilizzando il dizionario dei valori di campo di chiave e la matrice dei nomi di campo.Initializes a new instance of the DataKey class using the specified dictionary of key field values and array of field names.

Proprietà

IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataKey tiene traccia delle modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the DataKey object is tracking its view-state changes.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ottiene il valore del campo di chiave in corrispondenza dell'indice specificato da un oggetto DataKey.Gets the value of the key field at the specified index from a DataKey object.

Item[String] Item[String] Item[String] Item[String]

Ottiene il valore del campo di chiave con il nome di campo specificato da un oggetto DataKey.Gets the value of the key field with the specified field name from a DataKey object.

Value Value Value Value

Ottiene il valore del campo di chiave in corrispondenza del valore 0 dell'indice nell'oggetto DataKey.Gets the value of the key field at index 0 in the DataKey object.

Values Values Values Values

Ottiene un oggetto IOrderedDictionary che contiene tutti i campi di chiave presenti nell'oggetto DataKey.Gets an IOrderedDictionary object that contains every key field in the DataKey object.

Metodi

Equals(DataKey) Equals(DataKey) Equals(DataKey) Equals(DataKey)

Determina se la matrice DataKey specificata corrisponde alla chiave di dati corrente.Determines whether the specified DataKey array is equal to the current data key.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Consente di caricare lo stato di visualizzazione dell'oggetto DataKey precedentemente salvato.Loads the previously saved view state of the DataKey object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Salva lo stato di visualizzazione corrente dell'oggetto DataKey.Saves the current view state of the DataKey object.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Viene contrassegnato il punto iniziale per la registrazione e il salvataggio delle modifiche dello stato di visualizzazione nell'oggetto DataKey.Marks the starting point at which to begin tracking and saving view-state changes to the DataKey object.

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataKey tiene traccia delle modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the DataKey object is tracking its view-state changes.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Consente di caricare lo stato di visualizzazione dell'oggetto DataKey precedentemente salvato.Loads the previously saved view state of the DataKey object.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Salva lo stato di visualizzazione corrente dell'oggetto DataKey.Saves the current view state of the DataKey object.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Viene contrassegnato il punto iniziale per la registrazione e il salvataggio delle modifiche dello stato di visualizzazione nell'oggetto DataKey.Marks the starting point at which to begin tracking and saving view-state changes to the DataKey object.

Si applica a

Vedi anche