Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataKey classe

 

Date de publication : novembre 2016

Représente le ou les champs de clé primaire d’un enregistrement dans un contrôle lié aux données.

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)

System.Object
  System.Web.UI.WebControls.DataKey

public class DataKey : IStateManager, IEquatable<DataKey>

NomDescription
System_CAPS_pubmethodDataKey(IOrderedDictionary)

Initialise une nouvelle instance de la DataKey classe à l’aide du dictionnaire de valeurs de champ de clé spécifié.

System_CAPS_pubmethodDataKey(IOrderedDictionary, String[])

Initialise une nouvelle instance de la DataKey à l’aide du dictionnaire de valeurs de champs clés spécifié et le tableau de noms de champs de classe.

NomDescription
System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur indiquant si le DataKey objet effectue le suivi des modifications apportées à son état d’affichage.

System_CAPS_pubpropertyItem[Int32]

Obtient la valeur du champ clé à l’index spécifié à partir d’un DataKey objet.

System_CAPS_pubpropertyItem[String]

Obtient la valeur du champ clé avec le nom du champ spécifié dans un DataKey objet.

System_CAPS_pubpropertyValue

Obtient la valeur du champ clé à l’index 0 dans le DataKey objet.

System_CAPS_pubpropertyValues

Obtient un IOrderedDictionary objet qui contient tous les champs clés dans le DataKey objet.

NomDescription
System_CAPS_pubmethodEquals(DataKey)

Détermine si le texte spécifié DataKey tableau est égal à la clé de données actuelle.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection.(Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodLoadViewState(Object)

Charge l’état d’affichage précédemment enregistré de le DataKey objet.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodSaveViewState()

Enregistre l’état d’affichage actuel du DataKey objet.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodTrackViewState()

Marque le point de départ à partir duquel commencer le suivi et l’enregistrement d’état d’affichage change pour la DataKey objet.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Charge l’état d’affichage précédemment enregistré de le DataKey objet.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Enregistre l’état d’affichage actuel du DataKey objet.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Marque le point de départ à partir duquel commencer le suivi et l’enregistrement d’état d’affichage change pour la DataKey objet.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Obtient une valeur indiquant si le DataKey objet effectue le suivi des modifications apportées à son état d’affichage.

The T:System.Web.UI.WebControls.DataKey class is used to represent the primary key for a record in a data-bound control. The primary key for a record can be composed of one of more fields from the data source. Although the T:System.Web.UI.WebControls.DataKey class is not a collection, it can store multiple key field values. The key field values are populated when one of the constructors for the T:System.Web.UI.WebControls.DataKey class is called. You can retrieve a key field value from a T:System.Web.UI.WebControls.DataKey object in the following ways:

  • Use the P:System.Web.UI.WebControls.DataKey.Item(System.Int32) property to retrieve a key field value at a specific index in the T:System.Web.UI.WebControls.DataKey object.

  • Use the P:System.Web.UI.WebControls.DataKey.Item(System.String) property to retrieve a key field value of a specific field.

  • Use the P:System.Web.UI.WebControls.DataKey.Value property to retrieve the value of the key field at index 0 in the T:System.Web.UI.WebControls.DataKey object. This property is often used as a shortcut to retrieve the key value of a record when the primary key contains only one field.

  • Use the P:System.Web.UI.WebControls.DataKey.Values property to create an T:System.Collections.Specialized.IOrderedDictionary object that can be used to iterate through the key field values.

In general, T:System.Web.UI.WebControls.DataKey objects are automatically generated by data-bound controls when the control's DataKeyNames property is set. The T:System.Web.UI.WebControls.DataKey objects contain the values of the key field or fields specified in the DataKeyNames property. Data-bound controls that display a single record at a time (such as T:System.Web.UI.WebControls.DetailsView or T:System.Web.UI.WebControls.FormView) generally store the T:System.Web.UI.WebControls.DataKey object for the current record displayed in the DataKey property of the control. Data-bound controls that display multiple records at a time (such as T:System.Web.UI.WebControls.GridView) generally store the T:System.Web.UI.WebControls.DataKey objects for each record in the control in a T:System.Web.UI.WebControls.DataKeyArray collection. The T:System.Web.UI.WebControls.DataKeyArray collection is then stored in the DataKeys property of the control.

The following code example demonstrates how to determine the primary key value of a record in a T:System.Web.UI.WebControls.DetailsView control using the P:System.Web.UI.WebControls.DataKey.Value property of a T:System.Web.UI.WebControls.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 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>

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: