ClientIDMode Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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 ProductID
hodnotu . 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é
- ClientIDMode
- ClientIDMode
- ClientIDMode
- ClientIDMode
- ClientIDMode
- identifikace ovládacího prvku ASP.NET
- Postupy: Řízení přístupu z JavaScriptu podle ID
- Návod: Usnadnění přístupu k ovládacím prvkům Data-Bound z JavaScriptu
- Návod: Usnadnění přístupu k ovládacím prvkům umístěným ve webových uživatelských ovládacích prvcích z JavaScriptu
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro