Sdílet prostřednictvím

ClientIDMode Výčet

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

Name Hodnota Description
Inherit 0

Ovládací prvek dědí ClientIDMode nastavení jeho NamingContainer ovládacího prvku.
AutoID 1

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 je jediný, který byl k dispozici ve verzích ASP.NET starších než ASP.NET 4.
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 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. 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 pojmenování, ovládací prvek se použije 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 obsažené v ovládacím ListView prvku. V ovládacím prvku ListViewClientIDMode je vlastnost nastavena na Předvídatelná a ClientIDRowSuffix vlastnost je nastavena na ProductID. Z klientského skriptu můžete získat přístup ke konkrétní instanci na Label 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 ClientIDMode použijete při nastavení ClientIDMode vlastnosti ovládacího prvku. Hodnota, kterou přiřadíte k ClientIDMode vlastnosti, určuje způsob ClientID vygenerování vlastnosti. Hodnota ClientID vlastnosti se vykreslí jako id atribut v kódu a je to hodnota, kterou používáte pro přístup k ovládacímu prvku z klientského skriptu. Hodnota, kterou přiřadíte k ClientIDMode vlastnosti, nemá vliv na ID vlastnost ovládacího prvku serveru, pouze id atribut odpovídajícího elementu HTML.

Výchozí hodnota ClientIDMode stránky je předvídatelná. Výchozí hodnota ClientIDMode ovládacího prvku je Inherit.

Vzhledem k tomu, že výchozí nastavení ovládacích prvků je Zděděno, je výchozí režim generování předvídatelný. (Pokud ale pomocí sady Visual Studio převedete webový projekt na ASP.NET 4 ze starší verze, Sada Visual Studio automaticky nastaví výchozí hodnotu webu na Automatické ID v souboru Web.config.)

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

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

Platí pro

Viz také