Control.ClientIDMode Vlastnost

  • Reference

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á označuje, jak je ClientID vlastnost generována. Výchozí formát je Inherit.

Atributy
ThemeableAttribute

Příklady

Následující příklad ukazuje Label ovládací prvky, které jsou obsaženy v ovládacím ListView prvku. ListView U ovládacího prvku ClientIDMode je vlastnost nastavena na Predictable a ClientIDRowSuffix vlastnost je nastavena na ProductID. Ve vykresleném kódu 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 elementů 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ů pro vygenerování ClientID hodnoty vlastnosti. Algoritmus, který se má použít pro ovládací prvek, vyberete nastavením jeho ClientIDMode vlastnosti. Algoritmy jsou identifikovány hodnotami výčtu ClientIDMode , které jsou uvedeny v následující tabulce.

Hodnota Popis
AutoID Hodnota ClientID se vygeneruje zřetězením ID hodnot každého nadřazeného kontejneru názvů s ID hodnotou ovládacího prvku. Ve scénářích datových vazeb, ve kterých se vykresluje více instancí ovládacího prvku, se před hodnotu ovládacího prvku vloží přírůstková ID 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 názvů, použije se ovládací prvek 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 vygeneruje zřetězením ClientID hodnoty nadřazeného kontejneru názvů s ID hodnotou ovládacího prvku. Pokud je ovládací prvek ovládací prvek vázaný na data, který generuje více řádků, přidá se na konec hodnota datového pole zadaného ClientIDRowSuffix ve vlastnosti. GridView Pro ovládací prvek lze zadat více datových polí. ClientIDRowSuffix Pokud je vlastnost prázdná, přidá se na konec pořadové číslo místo hodnoty datového pole. Toto číslo začíná nulou 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í svého NamingContainer ovládacího prvku.

Výchozí hodnota ClientIDMode pro stránku 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 k převodu webového projektu na ASP.NET 4 ze starší verze použijete visual Studio, sada Visual Studio automaticky nastaví výchozí AutoID hodnotu webu v souboru Web.config.)

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

Platí pro

Viz také