Control.ClientIDMode Właściwość

Definicja

Pobiera lub ustawia algorytm używany do generowania wartości właściwości ClientID.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; }
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set
Public Overridable Property ClientIDMode As ClientIDMode

Wartość właściwości

ClientIDMode

Wartość, która wskazuje sposób generowania właściwości ClientID.A value that indicates how the ClientID property is generated. Wartość domyślna to Inherit.The default is Inherit.

Atrybuty

Przykłady

Poniższy przykład przedstawia kontrolki Label, które znajdują się w kontrolce ListView.The following example shows Label controls that are contained in a ListView control. W formancie ListView Właściwość ClientIDMode jest ustawiona na Predictable, a właściwość ClientIDRowSuffix jest ustawiona na ProductID.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. W renderowanym kodzie HTML tworzy trzy span elementy, które odpowiadają trzem ProductIDLabel kontrolkom.In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. Po uruchomieniu strony atrybuty id dla elementów span są ustawiane na następujące wartości: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>

Uwagi

ASP.NET udostępnia wiele algorytmów służących do generowania wartości właściwości ClientID.ASP.NET provides multiple algorithms for how to generate the ClientID property value. Wybierz algorytm, który ma być używany dla kontrolki, ustawiając jej Właściwość ClientIDMode.You select which algorithm to use for a control by setting its ClientIDMode property. Algorytmy są identyfikowane przez ClientIDMode wartości wyliczenia, które są wymienione w poniższej tabeli.The algorithms are identified by the ClientIDMode enumeration values that are listed in the following table.

WartośćValue OpisDescription
AutoID Wartość ClientID jest generowana przez połączenie ID wartości każdego nadrzędnego kontenera nazw z wartością ID formantu.The ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. W scenariuszach wiązania z danymi, w których renderowane jest wiele wystąpień kontrolki, wartość zwiększania jest wstawiana przed wartością ID formantu.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żdy segment jest oddzielony znakiem podkreślenia ().Each segment is separated by an underscore character (). Ten algorytm został użyty w wersjach programu ASP.NET wcześniejszych niż ASP.NET 4.This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.
Static Wartość ClientID jest ustawiona na wartość właściwości ID.The ClientID value is set to the value of the ID property. Jeśli formant jest kontenerem nazewnictwa, formant jest używany jako Góra hierarchii nazewnictwa kontenerów dla wszystkich kontrolek, które zawiera.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 Ten algorytm jest używany dla formantów, które znajdują się w formantach powiązanych z danymi.This algorithm is used for controls that are in data-bound controls. Wartość ClientID jest generowana przez połączenie ClientID wartości nadrzędnego kontenera nazw z wartością ID formantu.The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. Jeśli formant jest formantem związanym z danymi, który generuje wiele wierszy, wartość pola danych określonego we właściwości ClientIDRowSuffix jest dodawana na końcu.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. Dla kontrolki GridView można określić wiele pól danych.For the GridView control, multiple data fields can be specified. Jeśli właściwość ClientIDRowSuffix jest pusta, na końcu zostanie dodany numer sekwencyjny zamiast wartości pola danych.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data-field value. Ta liczba zaczyna się od zera i zwiększa się o 1 dla każdego wiersza.This number begins at zero and is incremented by 1 for each row. Każdy segment jest oddzielony znakiem podkreślenia ().Each segment is separated by an underscore character ().
Inherit Kontrolka dziedziczy ustawienie ClientIDMode kontrolki NamingContainer.The control inherits the ClientIDMode setting of its NamingContainer control.

Wartość domyślna ClientIDMode strony jest Predictable.The default value of ClientIDMode for a page is Predictable. Wartość domyślna ClientIDMode formantu jest Inherit.The default value of ClientIDMode for a control is Inherit. Ponieważ domyślnie dla formantów jest Inherit, domyślnym trybem generowania jest Predictable.Because the default for controls is Inherit, the default generation mode is Predictable. Jeśli jednak użyjesz programu Visual Studio do przekonwertowania projektu sieci Web na ASP.NET 4 ze starszej wersji, program Visual Studio automatycznie ustawi domyślną lokację AutoID w pliku 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.)

Aby uzyskać więcej informacji, zobacz Identyfikacja kontrolki serwera sieci Web ASP.NET.For more information, see ASP.NET Web Server Control Identification.

Dotyczy

Zobacz też