Control.ClientIDMode Vlastnost

Definice

Získá nebo nastaví algoritmus, který se použije k vygenerování hodnoty ClientID Vlastnosti.Gets or sets the algorithm that is used to generate the value of the ClientID property.

public:
 virtual property System::Web::UI::ClientIDMode ClientIDMode { System::Web::UI::ClientIDMode get(); void set(System::Web::UI::ClientIDMode value); };
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.ClientIDMode ClientIDMode { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set
Public Overridable Property ClientIDMode As ClientIDMode

Hodnota vlastnosti

ClientIDMode

Hodnota, která určuje, jak ClientID je vlastnost generována.A value that indicates how the ClientID property is generated. Výchozí formát je Inherit.The default is Inherit.

Atributy

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 hodnotu Predictable 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. Ve vykresleném HTML vytvoří to tři span prvky, které odpovídají třem ProductIDLabel ovládacím prvkům.In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. Při spuštění stránky id jsou atributy pro span prvky nastaveny na následující hodnoty:When the page runs, the id attributes for the span elements are set to the following values:

  • 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

ASP.NET poskytuje několik algoritmů pro generování ClientID hodnoty vlastnosti.ASP.NET provides multiple algorithms for how to generate the ClientID property value. Můžete vybrat, který algoritmus se má použít pro ovládací prvek nastavením jeho ClientIDMode Vlastnosti.You select which algorithm to use for a control by setting its ClientIDMode property. Algoritmy jsou identifikovány ClientIDMode hodnotami výčtu, které jsou uvedeny v následující tabulce.The algorithms are identified by the ClientIDMode enumeration values that are listed in the following table.

HodnotaValue PopisDescription
AutoID 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 se použil ve verzích ASP.NET starších než ASP.NET 4.This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.
Static 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.
Predictable 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. Toto číslo začíná nulou a pro každý řádek se zvýší o 1.This number begins at zero and is incremented by 1 for each row. Každý segment je oddělen znakem podtržítka ().Each segment is separated by an underscore character ().
Inherit Ovládací prvek dědí ClientIDMode nastavení jeho NamingContainer ovládacího prvku.The control inherits the ClientIDMode setting of its NamingContainer control.

Výchozí hodnota ClientIDMode pro stránku je Predictable .The default value of ClientIDMode for a page is Predictable. Výchozí hodnota ClientIDMode pro ovládací prvek je Inherit .The default value of ClientIDMode for a control is Inherit. Vzhledem k tomu, že výchozí nastavení pro ovládací prvky je Inherit , je výchozí režim generování Predictable .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 soubor 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.)

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é