Sdílet prostřednictvím

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, který je přístupný 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 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 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 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. Každý segment je oddělený podtržítkem (_).
Static 3

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.

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 ClientIDMode je vlastnost nastavená na hodnotu Předvídatelná a ClientIDRowSuffix vlastnost je nastavená na ProductIDhodnotu . Z klientského skriptu můžete získat přístup ke konkrétní instanci objektu Label na ProductID základě 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 se vykreslí 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 atribut id 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í nastavení ovládacích prvků 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 v souboru Web.config automaticky nastaví výchozí hodnotu webu na AutoID.)

Hodnotu všech stránek 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é