ClientIDMode Výčet

Definice

Určuje, jak ASP.NET generuje ClientID pro ovládací prvek, který je k dispozici v klientském skriptu.Specifies how ASP.NET generates the ClientID for a control that can be accessed in client script.

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

Pole

AutoID 1

ClientIDHodnota je generována zřetězením ID hodnot jednotlivých nadřazených názvových kontejnerů s ID hodnotou ovládacího prvku.The ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. V případech vázání dat, při kterých je vykresleno více instancí ovládacího prvku, je hodnota zvýšení hodnoty vložena před hodnoty ovládacího prvku ID .In data-binding scenarios where multiple instances of a control are rendered, an incrementing value is inserted in front of the control's ID value. Každý segment je oddělen znakem podtržítka ().Each segment is separated by an underscore character (). Tento algoritmus je jediným z nich, který byl k dispozici ve verzích ASP.NET starších než ASP.NET 4.This algorithm is the only one that was available in versions of ASP.NET earlier than ASP.NET 4.

Inherit 0

Ovládací prvek dědí ClientIDMode nastavení jeho NamingContainer ovládacího prvku.The control inherits the ClientIDMode setting of its NamingContainer control.

Predictable 2

Tento algoritmus se používá pro ovládací prvky, které jsou v ovládacích prvcích vázaných na data.This algorithm is used for controls that are in data-bound controls. ClientIDHodnota je generována zřetězením ClientID hodnoty nadřazeného názvového kontejneru s ID hodnotou ovládacího prvku.The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. Pokud je 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.If the control is a data-bound control that generates multiple rows, the value of the data field specified in the ClientIDRowSuffix property is added at the end. Pro GridView ovládací prvek lze zadat více datových polí.For the GridView control, multiple data fields can be specified. Pokud ClientIDRowSuffix je vlastnost prázdná, místo hodnoty datového pole se přidá pořadové číslo na konci.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data field value. Každý segment je oddělen znakem podtržítka ().Each segment is separated by an underscore character ().

Static 3

ClientIDHodnota je nastavena na hodnotu ID Vlastnosti.The ClientID value is set to the value of the ID property. Pokud je ovládací prvek názvový kontejner, ovládací prvek je použit jako začátek hierarchie názvových kontejnerů pro všechny ovládací prvky, které obsahuje.If the control is a naming container, the control is used as the top of the hierarchy of naming containers for any controls that it contains.

Příklady

Následující příklad ukazuje Label ovládací prvky, které jsou obsaženy v ListView ovládacím prvku.The following example shows Label controls that are contained in a ListView control. V ListView ovládacím prvku ClientIDMode je vlastnost nastavena na předvídatelné a ClientIDRowSuffix vlastnost je nastavena na hodnotu ProductID .On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. Z klientského skriptu můžete přistupovat ke konkrétní instanci nástroje na Label základě ProductID hodnoty instance, ke které se snažíte získat přístup.From client script, you can access a particular instance of a Label based on the ProductID value of the instance that you are trying to access.

Tento příklad vytvoří HTML se třemi ProductIDLabel ovládacími prvky.This example creates HTML with three ProductIDLabel controls. Při spuštění stránky budou identifikátory pro ovládací prvky následující:When the page runs, the IDs for the controls will be the following:

  • 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 se používá ClientIDMode při nastavení ClientIDMode vlastnosti ovládacího prvku.You use the ClientIDMode enumeration when you set the ClientIDMode property for a control. Hodnota, kterou přiřadíte ClientIDMode vlastnosti určuje, jak ClientID je vlastnost generována.The value that you assign to the ClientIDMode property determines how the ClientID property is generated. Hodnota ClientID vlastnosti je vykreslena jako id atribut v kódu a jedná se o hodnotu, kterou používáte pro přístup k ovládacímu prvku z klientského skriptu.The value of the ClientID property is rendered as the id attribute in markup, and it is the value that you use to access the control from client script. Hodnota, kterou přiřadíte ClientIDMode vlastnosti, nemá vliv na ID vlastnost ovládacího prvku serveru, pouze na id atribut odpovídajícího prvku HTML.The value that you assign to the ClientIDMode property does not affect the ID property of the server control, only the id attribute of the corresponding HTML element.

Výchozí hodnota ClientIDMode pro stránku je předvídatelná.The default value of ClientIDMode for a page is Predictable. Výchozí hodnota ClientIDMode ovládacího prvku je dědění.The default value of ClientIDMode for a control is Inherit.

Vzhledem k tomu, že výchozí nastavení pro ovládací prvky je děděno, je výchozí režim generování předvídatelný.Because the default for controls is Inherit, the default generation mode is Predictable. (Pokud však použijete sadu Visual Studio k převedení webového projektu na ASP.NET 4 ze starší verze, sada Visual Studio automaticky nastaví výchozí nastavení lokality na AutoID v souboru Web.config.)(However, if you use Visual Studio to convert a Web project to ASP.NET 4 from an earlier version, Visual Studio automatically sets the site default to AutoID in the Web.config file.)

Můžete nastavit ClientIDMode hodnotu pro všechny stránky webu nastavením prvku stránky v souboru Web.config webu.You can set the ClientIDMode value for all pages in a Web site by setting the pages element in the site's Web.config file. Můžete nastavit ClientIDMode hodnotu stránky v direktivě @ Page .You can set the ClientIDMode value for a page in the @ Page directive.

Další informace naleznete v tématu Identifikace ovládacího prvku webového serveru ASP.NET.For more information, see ASP.NET Web Server Control Identification.

Platí pro

Viz také