Partager via

Control.ClientIDMode Propriété

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété.

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; }
[<System.Web.UI.Themeable(false)>]
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set
Public Overridable Property ClientIDMode As ClientIDMode

Valeur de propriété

ClientIDMode

Valeur qui indique la façon dont la ClientID propriété est générée. La valeur par défaut est Inherit.

Attributs
ThemeableAttribute

Exemples

L’exemple suivant montre Label les contrôles contenus dans un ListView contrôle. Sur le ListView contrôle, la ClientIDMode propriété est définie Predictable sur et la ClientIDRowSuffix propriété est définie sur ProductID. Dans le code HTML rendu, cela crée trois span éléments qui correspondent à trois ProductIDLabel contrôles. Lorsque la page s’exécute, les id attributs des span éléments sont définis sur les valeurs suivantes :

  • ListView1_ProductIDLabel_1
  • ListView1_ProductIDLabel_34
  • ListView1_ProductIDLabel_43
<asp:XmlDataSource ID="XmlDataSource1" runat="server" 
                   XPath="Products/Product">
  <Data>
    <Products>
      <Product ProductID="1"  ProductName="Chai" />
      <Product ProductID="34" ProductName="Ale" />
      <Product ProductID="43" ProductName="Coffee" />
    </Products>
  </Data>
</asp:XmlDataSource>

<asp:ListView ID="ListView1" 
              ClientIDMode="Predictable" 
              ClientIDRowSuffix="ProductID"  
              DataSourceID="XmlDataSource1" runat="server" >
  <ItemTemplate>
    ProductID: 
    <asp:Label ID="ProductIDLabel" runat="server" 
               Text='<%# Eval("ProductID") %>' />
    <br />
    ProductName:
    <asp:Label ID="ProductNameLabel" runat="server" 
               Text='<%# Eval("ProductName") %>' />
    <br />
    <br />
  </ItemTemplate>

  <LayoutTemplate>
    <div ID="itemPlaceholderContainer" runat="server">
      <span ID="itemPlaceholder" runat="server" />
    </div>
    <div>
    </div>
  </LayoutTemplate>
  
</asp:ListView>

Remarques

ASP.NET fournit plusieurs algorithmes pour générer la valeur de propriété ClientID . Vous sélectionnez l’algorithme à utiliser pour un contrôle en définissant sa ClientIDMode propriété. Les algorithmes sont identifiés par les ClientIDMode valeurs d’énumération répertoriées dans le tableau suivant.

Valeur Description
AutoID La ClientID valeur est générée en concaténant les ID valeurs de chaque conteneur d’affectation de noms parent avec la ID valeur du contrôle. Dans les scénarios de liaison de données où plusieurs instances d’un contrôle sont rendues, une valeur d’incrémentation est insérée devant la valeur du ID contrôle. Chaque segment est séparé par un caractère de soulignement (_). Cet algorithme a été utilisé dans les versions de ASP.NET antérieures à ASP.NET 4.
Static La ClientID valeur est définie sur la valeur de la ID propriété. Si le contrôle est un conteneur d’affectation de noms, le contrôle est utilisé en haut de la hiérarchie des conteneurs d’affectation de noms pour tous les contrôles qu’il contient.
Predictable Cet algorithme est utilisé pour les contrôles qui se trouvent dans des contrôles liés aux données. La ClientID valeur est générée en concaténant la ClientID valeur du conteneur d’affectation de noms parent avec la ID valeur du contrôle. 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é dans la ClientIDRowSuffix propriété est ajoutée à la fin. Pour le GridView contrôle, plusieurs champs de données peuvent être spécifiés. 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. Ce nombre commence à zéro et est incrémenté de 1 pour chaque ligne. Chaque segment est séparé par un caractère de soulignement (_).
Inherit Le contrôle hérite du ClientIDMode paramètre de son NamingContainer contrôle.

La valeur par défaut d’une ClientIDMode page est Predictable. La valeur par défaut d’un ClientIDMode contrôle est 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 Predictable. (Toutefois, si vous utilisez Visual Studio pour convertir un projet Web en ASP.NET 4 à partir d’une version antérieure, Visual Studio définit automatiquement le site par défaut AutoID dans le fichier Web.config.)

Pour plus d’informations, consultez ASP.NET Identification du contrôle de serveur web.

S’applique à

Voir aussi