Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
DataKey, classe
Représente le ou les champs clés primaires d'un enregistrement dans un contrôle lié aux données.
Assembly : System.Web (dans System.Web.dll)
Le type DataKey expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
DataKey(IOrderedDictionary) | Initialise une nouvelle instance de la classe DataKey à l'aide du dictionnaire de valeurs de champs clés spécifié. |
|
|
DataKey(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. |
| Nom | Description | |
|---|---|---|
|
IsTrackingViewState | Obtient une valeur indiquant si l'objet DataKey effectue le suivi des modifications de son état d'affichage. |
|
Item[Int32] | Obtient la valeur de champ clé à l'index spécifié d'un objet DataKey. |
|
|
Item[String] | Obtient la valeur du champ clé avec le nom de champ spécifié d'un objet DataKey. |
|
|
Value | Obtient la valeur du champ clé à l'index 0 dans l'objet DataKey. |
|
|
Values | Obtient un objet IOrderedDictionary qui contient tous les champs clés de l'objet DataKey. |
| Nom | Description | |
|---|---|---|
|
|
Equals(DataKey) | Détermine si le tableau DataKey spécifié est égal à la clé de données actuelle. |
|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
LoadViewState | Charge l'état d'affichage enregistré précédemment de l'objet DataKey. |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
SaveViewState | Enregistre l'état d'affichage actuel de l'objet DataKey. |
|
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
|
|
TrackViewState | Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées à l'objet DataKey. |
| Nom | Description | |
|---|---|---|
|
IStateManager.IsTrackingViewState | Obtient une valeur indiquant si l'objet DataKey effectue le suivi des modifications de son état d'affichage. |
|
IStateManager.LoadViewState | Infrastructure. Charge l'état d'affichage enregistré précédemment de l'objet DataKey. |
|
|
IStateManager.SaveViewState | Infrastructure. Enregistre l'état d'affichage actuel de l'objet DataKey. |
|
|
IStateManager.TrackViewState | Infrastructure. Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées à l'objet DataKey. |
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>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
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.
