ClientIDMode ClientIDMode ClientIDMode ClientIDMode Enum

Définition

Spécifie la façon dont ASP.NET génère ClientID pour un contrôle accessible dans un script client.Specifies how ASP.NET generates the ClientID for a control that can be accessed in client script.

public enum class ClientIDMode
public enum ClientIDMode
type ClientIDMode = 
Public Enum ClientIDMode
Héritage

Champs

AutoID AutoID AutoID AutoID 1

La valeur de la propriété ClientID est générée par concaténation des valeurs de la propriété ID de chaque conteneur d'attribution de noms parent à la valeur de la propriété ID du contrôle.The ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. Dans les scénarios de liaison de données où plusieurs instances d'un contrôle sont restituées, une valeur d'incrémentation est insérée devant la valeur de la propriété ID du contrôle.In data-binding scenarios where multiple instances of a control are rendered, an incrementing value is inserted in front of the control's ID value. Chaque segment est séparé par un trait de soulignement ().Each segment is separated by an underscore character (). Cet algorithme est le seul qui était disponible dans les versions d’ASP.NET antérieures à ASP.NET 4.This algorithm is the only one that was available in versions of ASP.NET earlier than ASP.NET 4.

Inherit Inherit Inherit Inherit 0

Le contrôle hérite du paramètre de ClientIDMode de son contrôle NamingContainer.The control inherits the ClientIDMode setting of its NamingContainer control.

Predictable Predictable Predictable Predictable 2

Cet algorithme est utilisé pour les contrôles contenus dans des contrôles liés aux données.This algorithm is used for controls that are in data-bound controls. La valeur de la propriété ClientID est générée par concaténation de la valeur de la propriété ClientID du conteneur d'attribution de noms parent à la valeur de la propriété ID du contrôle.The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. Si le contrôle est un contrôle lié aux données qui génère plusieurs lignes, la valeur du champ de données spécifiée dans la propriété ClientIDRowSuffix est ajoutée à la fin.If the control is a data-bound control that generates multiple rows, the value of the data field specified in the ClientIDRowSuffix property is added at the end. Pour le contrôle GridView, plusieurs champs de données peuvent être spécifiés.For the GridView control, multiple data fields can be specified. Si la propriété ClientIDRowSuffix est vide, un numéro séquentiel est ajouté à la fin au lieu d'une valeur de champ de données.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data field value. Chaque segment est séparé par un trait de soulignement ().Each segment is separated by an underscore character ().

Static Static Static Static 3

La propriété ClientID a la valeur de la propriété ID.The ClientID value is set to the value of the ID property. Si le contrôle est un conteneur d'attribution de noms, il est utilisé comme élément le plus élevé de la hiérarchie des conteneurs d'attribution de noms pour tous les contrôles qu'il contient.If the control is a naming container, the control is used as the top of the hierarchy of naming containers for any controls that it contains.

Exemples

L’exemple suivant montre Label les contrôles contenus dans un ListView contrôle.The following example shows Label controls that are contained in a ListView control. Sur le ListView contrôle, la ClientIDMode propriété est définie sur prévisible et ProductIDla ClientIDRowSuffix propriété a la valeur.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. À partir du script client, vous pouvez accéder à une instance Label particulière d’un ProductID en fonction de la valeur de l’instance à laquelle vous tentez d’accéder.From client script, you can access a particular instance of a Label based on the ProductID value of the instance that you are trying to access.

Cet exemple crée du code HTML ProductIDLabel avec trois contrôles.This example creates HTML with three ProductIDLabel controls. Lorsque la page s’exécute, les ID des contrôles sont les suivants:When the page runs, the IDs for the controls will be the following:

  • ListView1_ProductIDLabel_1

  • ListView1_ProductIDLabel_34

  • ListView1_ProductIDLabel_43

Pour plus d’informations, consultez identification du contrôle serveur Web ASP.netFor more information, see ASP.NET Web Server Control Identification

Remarques

Vous utilisez l' ClientIDMode énumération lorsque vous définissez ClientIDMode la propriété d’un contrôle.You use the ClientIDMode enumeration when you set the ClientIDMode property for a control. La valeur que vous affectez à ClientIDMode la propriété détermine la ClientID façon dont la propriété est générée.The value that you assign to the ClientIDMode property determines how the ClientID property is generated. La valeur de la ClientID propriété est rendue sous la id forme de l’attribut dans le balisage, et il s’agit de la valeur que vous utilisez pour accéder au contrôle à partir du script client.The value of the ClientID property is rendered as the id attribute in markup, and it is the value that you use to access the control from client script. La valeur que vous affectez à ClientIDMode la propriété n’affecte pas ID la propriété du contrôle serveur, mais uniquement id l’attribut de l’élément HTML correspondant.The value that you assign to the ClientIDMode property does not affect the ID property of the server control, only the id attribute of the corresponding HTML element.

La valeur par défaut ClientIDMode de pour une page est prévisible.The default value of ClientIDMode for a page is Predictable. La valeur par défaut ClientIDMode de pour un contrôle est Inherit.The default value of ClientIDMode for a control is Inherit.

Étant donné que la valeur par défaut pour les contrôles est Inherit, le mode de génération par défaut est prévisible.Because the default for controls is Inherit, the default generation mode is Predictable. (Toutefois, si vous utilisez Visual Studio pour convertir un projet Web en ASP.NET 4 d’une version antérieure, Visual Studio définit automatiquement la valeur par défaut du site sur AutoID dans le fichier Web. config.)(However, if you use Visual Studio to convert a Web project to ASP.NET 4 from an earlier version, Visual Studio automatically sets the site default to AutoID in the Web.config file.)

Vous pouvez définir la ClientIDMode valeur de toutes les pages d’un site Web en définissant l’élément pages dans le fichier Web. config du site.You can set the ClientIDMode value for all pages in a Web site by setting the pages element in the site's Web.config file. Vous pouvez définir la ClientIDMode valeur d’une page dans la directive @ page .You can set the ClientIDMode value for a page in the @ Page directive.

Pour plus d’informations, consultez Identification du contrôle serveur web ASP.NET.For more information, see ASP.NET Web Server Control Identification.

S’applique à

Voir aussi