Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

DataKey, classe

Représente le ou les champs clés primaires d'un enregistrement dans un contrôle lié aux données.

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

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

public class DataKey : IStateManager, IEquatable<DataKey>

Le type DataKey expose les membres suivants.

  NomDescription
Méthode publiqueDataKey(IOrderedDictionary)Initialise une nouvelle instance de la classe DataKey à l'aide du dictionnaire de valeurs de champs clés spécifié.
Méthode publiqueDataKey(IOrderedDictionary, String[])Initialise une nouvelle instance de la classe DataKey à l'aide du dictionnaire de valeurs de champs clés et du tableau de noms des champs spécifiés.
Début

  NomDescription
Propriété protégéeIsTrackingViewStateObtient une valeur indiquant si l'objet DataKey effectue le suivi des modifications de son état d'affichage.
Propriété publiqueItem[Int32]Obtient la valeur de champ clé à l'index spécifié d'un objet DataKey.
Propriété publiqueItem[String]Obtient la valeur du champ clé avec le nom de champ spécifié d'un objet DataKey.
Propriété publiqueValueObtient la valeur du champ clé à l'index 0 dans l'objet DataKey.
Propriété publiqueValuesObtient un objet IOrderedDictionary qui contient tous les champs clés de l'objet DataKey.
Début

  NomDescription
Méthode publiqueEquals(DataKey)Détermine si le tableau DataKey spécifié est égal à la clé de données actuelle.
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeLoadViewStateCharge l'état d'affichage enregistré précédemment de l'objet DataKey.
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeSaveViewStateEnregistre l'état d'affichage actuel de l'objet DataKey.
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode protégéeTrackViewStateMarque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées à l'objet DataKey.
Début

  NomDescription
Implémentation d'interface explicitePropriété privéeIStateManager.IsTrackingViewStateObtient une valeur indiquant si l'objet DataKey effectue le suivi des modifications de son état d'affichage.
Implémentation d'interface expliciteMéthode privéeIStateManager.LoadViewStateInfrastructure. Charge l'état d'affichage enregistré précédemment de l'objet DataKey.
Implémentation d'interface expliciteMéthode privéeIStateManager.SaveViewStateInfrastructure. Enregistre l'état d'affichage actuel de l'objet DataKey.
Implémentation d'interface expliciteMéthode privéeIStateManager.TrackViewStateInfrastructure. Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées à l'objet DataKey.
Début

La classe DataKey est utilisée pour représenter la clé primaire d'un enregistrement dans un contrôle lié aux données. La clé primaire d'un enregistrement peut être composée d'un ou plusieurs champs de la source de données. Bien que la classe DataKey ne soit pas une collection, elle peut stocker plusieurs valeurs de champs clés. Les valeurs de champs clés sont remplies lorsque l'un des constructeurs de la classe DataKey est appelé. Vous pouvez récupérer une valeur de champ clé d'un objet DataKey selon une des manières suivantes :

  • Utilisez la propriété DataKey.Item[Int32] pour récupérer une valeur de champ clé à un index spécifique dans l'objet DataKey.

  • Utilisez la propriété DataKey.Item[String] pour récupérer une valeur de champ clé d'un champ spécifique.

  • Utilisez la propriété Value pour récupérer la valeur du champ clé à l'index 0 dans l'objet DataKey. Cette propriété est souvent utilisée comme raccourci pour récupérer la valeur de clé d'un enregistrement lorsque la clé primaire contient un seul champ.

  • Utilisez la propriété Values pour créer un objet IOrderedDictionary qui peut être utilisé pour itérer au sein des valeurs de champs clés.

En général, les objets DataKey sont générés automatiquement par des contrôles liés aux données lorsque la propriété DataKeyNames du contrôle est définie. Les objets DataKey contiennent les valeurs du ou des champs clés spécifiés dans la propriété DataKeyNames. Les contrôles liés aux données qui affichent un seul enregistrement à la fois (tel que DetailsView ou FormView) stockent généralement l'objet DataKey pour l'enregistrement en cours affiché dans la propriété DataKey du contrôle. Les contrôles liés aux données qui affichent plusieurs enregistrements à la fois (tel que GridView) stockent généralement les objets DataKey pour chaque enregistrement dans le contrôle dans une collection DataKeyArray. La collection DataKeyArray est alors stockée dans la propriété DataKeys du contrôle.

L'exemple de code suivant illustre comment déterminer la valeur de clé primaire d'un enregistrement dans un contrôle DetailsView à l'aide de la propriété Value d'un objet DataKey.



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

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft