ClientIDMode Výčet

  • Reference

Definice

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

Určuje, jak ASP.NET vygeneruje ClientID pro ovládací prvek, ke kterému lze přistupovat v klientském skriptu.

public enum class ClientIDMode
public enum ClientIDMode
type ClientIDMode = 
Public Enum ClientIDMode
Dědičnost
Object
ValueType
Enum
ClientIDMode

Pole

AutoID 1

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 je jediný, který byl k dispozici ve verzích ASP.NET starších než ASP.NET 4.
Inherit 0

Ovládací prvek dědí ClientIDMode nastavení svého NamingContainer ovládacího prvku.
Predictable 2

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á, místo hodnoty datového pole se na konec přidá pořadové číslo. Každý segment je oddělený znakem podtržítka (_).
Static 3

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.

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 Předvídatelná a ClientIDRowSuffix vlastnost je nastavena na ProductIDhodnotu . Z klientského Label skriptu můžete získat přístup ke konkrétní instanci na základě ProductID hodnoty instance, ke které se pokoušíte získat přístup.

Tento příklad vytvoří HTML se třemi ProductIDLabel ovládacími prvky. Po spuštění stránky budou ID ovládacích prvků následující:

  • 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

Výčet použijete ClientIDMode při nastavení ClientIDMode vlastnosti ovládacího prvku. Hodnota, kterou přiřadíte vlastnosti ClientIDMode , určuje způsob ClientID generování vlastnosti. Hodnota ClientID vlastnosti je vykreslena jako id atribut v kódu a je to hodnota, kterou použijete pro přístup k ovládacímu prvku z klientského skriptu. Hodnota, kterou přiřadíte vlastnosti ClientIDMode nemá vliv na ID vlastnost serverového ovládacího prvku, pouze id atribut odpovídajícího elementu HTML.

Výchozí hodnota ClientIDMode pro stránku je Předvídatelná. Výchozí hodnota ClientIDMode ovládacího prvku je Zdědit.

Vzhledem k tomu, že výchozí hodnota pro ovládací prvky je Zdědit, výchozí režim generování je Předvídatelný. (Pokud ale použijete Visual Studio k převodu webového projektu na ASP.NET 4 ze starší verze, sada Visual Studio automaticky nastaví výchozí hodnotu webu na AutoID v souboru Web.config.)

Hodnotu pro všechny stránky na webu můžete nastavit ClientIDMode nastavením prvku pages v souboru Web.config webu. Hodnotu stránky můžete nastavit ClientIDMode v direktivě @ Page .

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

Platí pro

Viz také