Sdílet prostřednictvím

Control.ClientIDMode Vlastnost

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti.

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

Hodnota vlastnosti

ClientIDMode

Hodnota, která určuje, jak ClientID se vlastnost generuje. Výchozí hodnota je Inherit.

Atributy
ThemeableAttribute

Příklady

Následující příklad ukazuje Label ovládací prvky obsažené v ovládacím ListView prvku. Na ovládacím ListView prvku ClientIDMode je vlastnost nastavena Predictable a ClientIDRowSuffix vlastnost je nastavena na ProductID. V vykresleném HTML se vytvoří tři span prvky, které odpovídají třem ProductIDLabel ovládacím prvkům. Při spuštění id stránky jsou atributy prvků span nastaveny na následující hodnoty:

  • 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>

Poznámky

ASP.NET poskytuje více algoritmů, jak vygenerovat ClientID hodnotu vlastnosti. Výběrem algoritmu, který se má použít pro ovládací prvek, nastavíte jeho ClientIDMode vlastnost. Algoritmy jsou identifikovány hodnotami výčtu ClientIDMode , které jsou uvedeny v následující tabulce.

Hodnota Description
AutoID Tato ClientID hodnota se vygeneruje zřetězením ID hodnot každého nadřazeného kontejneru pojmenování s ID hodnotou ovládacího prvku. Ve scénářích datových vazeb, ve kterých se vykreslí více instancí ovládacího prvku, se před hodnotu ovládacího prvku ID vloží přírůstková hodnota. Každý segment je oddělený znakem podtržítka (_). Tento algoritmus byl použit ve verzích ASP.NET starších než ASP.NET 4.
Static Hodnota ClientID je nastavena na hodnotu ID vlastnosti. Pokud je ovládací prvek kontejner pojmenování, ovládací prvek se použije jako horní část hierarchie pojmenování kontejnerů pro všechny ovládací prvky, které obsahuje.
Predictable Tento algoritmus se používá pro ovládací prvky, které jsou v ovládacích prvcích vázaných na data. Hodnota ClientID se generuje zřetězením ClientID hodnoty nadřazeného kontejneru pojmenování s ID hodnotou ovládacího prvku. Pokud je ovládací prvek vázaný na data, který generuje více řádků, hodnota datového pole zadaného ve ClientIDRowSuffix vlastnosti se přidá na konec. GridView Pro ovládací prvek lze zadat více datových polí. ClientIDRowSuffix Pokud je vlastnost prázdná, na konci se místo hodnoty datového pole přidá pořadové číslo. Toto číslo začíná na nule a pro každý řádek se zvýší o 1. Každý segment je oddělený znakem podtržítka (_).
Inherit Ovládací prvek dědí ClientIDMode nastavení jeho NamingContainer ovládacího prvku.

Výchozí hodnota ClientIDMode stránky je Predictable. Výchozí hodnota ClientIDMode ovládacího prvku je Inherit. Vzhledem k tomu, že výchozí pro ovládací prvky je Inherit, výchozí režim generování je Predictable. (Pokud ale pomocí sady Visual Studio převedete webový projekt na ASP.NET 4 ze starší verze, sada Visual Studio automaticky nastaví výchozí nastavení AutoID webu v souboru Web.config.)

Další informace naleznete v tématu ASP.NET Identifikace ovládacího prvku webového serveru.

Platí pro

Viz také