Sdílet prostřednictvím

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

Atributy
ThemeableAttribute

Příklady

Následující příklad ukazuje Label ovládací prvky obsažené v ovládacím ListView prvku. ListView U ovládacího prvku je vlastnost nastavená ClientIDMode na Predictable a vlastnost je nastavená ClientIDRowSuffix 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 několik algoritmů pro vygenerování ClientID hodnoty vlastnosti. Algoritmus, který se má pro ovládací prvek použít, 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 se ClientID generuje zřetězením ID hodnot každého nadřazeného názvového kontejneru s ID hodnotou ovládacího prvku. Ve scénářích datových vazeb, kde je vykresleno 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ý podtržítkem (_). 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 názvový kontejner, 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 se ClientID generuje zřetězením ClientID hodnoty nadřazeného názvového kontejneru s ID hodnotou ovládacího prvku. Pokud je ovládací prvek ovládací prvek vázaný na data, který generuje více řádků, je hodnota datového pole zadaná ve ClientIDRowSuffix vlastnosti přidána na konec. 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 navyšuje o 1. Každý segment je oddělený podtržítkem (_).
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 pro ovládací prvek je Inherit. Vzhledem k tomu, že výchozí nastavení ovládacích prvků je Inherit, výchozí režim generování je Predictable. (Pokud ale použijete Visual Studio k převodu webového projektu na ASP.NET 4 ze starší verze, Sada Visual Studio automaticky nastaví web ve Web.config souboru na AutoID výchozí hodnotu.)

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

Platí pro

Viz také