Control.ClientIDMode Control.ClientIDMode Control.ClientIDMode Control.ClientIDMode Property

Définition

Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

public:
 virtual property System::Web::UI::ClientIDMode ClientIDMode { System::Web::UI::ClientIDMode get(); void set(System::Web::UI::ClientIDMode value); };
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.ClientIDMode ClientIDMode { get; set; }
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set
Public Overridable Property ClientIDMode As ClientIDMode

Valeur de propriété

Valeur qui indique comment la propriété ClientID est générée.A value that indicates how the ClientID property is generated. La valeur par défaut est Inherit.The default is Inherit.

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é a la valeur Predictable et la ClientIDRowSuffix propriété a la valeur ProductID.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. Dans le HTML rendu, cela crée trois span éléments qui correspondent à trois ProductIDLabel contrôles.In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. Lorsque la page s’exécute, id les attributs span des éléments sont définis avec les valeurs suivantes :When the page runs, the id attributes for the span elements are set to the following values:

  • ListView1_ProductIDLabel_1

  • ListView1_ProductIDLabel_34

  • ListView1_ProductIDLabel_43

Remarques

ASP.NET fournit plusieurs algorithmes pour la génération de la ClientID valeur de propriété.ASP.NET provides multiple algorithms for how to generate the ClientID property value. Vous sélectionnez l’algorithme à utiliser pour un contrôle en définissant sa ClientIDMode propriété.You select which algorithm to use for a control by setting its ClientIDMode property. Les algorithmes sont identifiés par les ClientIDMode valeurs d’énumération qui sont répertoriées dans le tableau suivant.The algorithms are identified by the ClientIDMode enumeration values that are listed in the following table.

ValueValue DescriptionDescription
AutoID 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 a été utilisé dans les versions de ASP.NET antérieures à ASP.NET 4.This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.
Static 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.
Predictable 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 ClientIDRowSuffix propriété est vide, un nombre 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. Ce nombre commence à zéro et est incrémenté de 1 pour chaque ligne.This number begins at zero and is incremented by 1 for each row. Chaque segment est séparé par un trait de soulignement ().Each segment is separated by an underscore character ().
Inherit 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.

La valeur par défaut ClientIDMode de pour une page Predictableest.The default value of ClientIDMode for a page is Predictable. La valeur par défaut ClientIDMode de pour un contrôle Inheritest.The default value of ClientIDMode for a control is Inherit. Étant donné que la valeur par Inheritdéfaut pour les contrôles est, Predictablele mode de génération par défaut est.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 AutoID du site sur 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.)

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