Поделиться через

Control.ClientIDMode Свойство

Определение

Пространство имен:
System.Web.UI
Сборка:
System.Web.dll

Возвращает или задает алгоритм, используемый для создания значения ClientID свойства.

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

Значение свойства

ClientIDMode

Значение, указывающее, как ClientID создается свойство. Значение по умолчанию — Inherit.

Атрибуты
ThemeableAttribute

Примеры

В следующем примере показаны Label элементы управления, содержащиеся в элементе ListView управления. В элементе ListView управления ClientIDMode для свойства задано значение, а ClientIDRowSuffix для свойства Predictable задано значение ProductID. В отрисованном HTML это создает три span элемента, соответствующие трем ProductIDLabel элементам управления. При запуске id страницы атрибуты элементов span задаются следующими значениями:

  • 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>

Комментарии

ASP.NET предоставляет несколько алгоритмов создания ClientID значения свойства. Вы выбираете алгоритм, используемый для элемента управления, задав его ClientIDMode свойство. Алгоритмы определяются значениями ClientIDMode перечисления, перечисленными в следующей таблице.

Ценность Описание
AutoID Это ClientID значение создается путем объединения ID значений каждого родительского контейнера именования со ID значением элемента управления. В сценариях привязки данных, в которых отрисовывается несколько экземпляров элемента управления, перед значением элемента управления ID вставляется добавочное значение. Каждый сегмент отделяется символом подчеркивания (_). Этот алгоритм использовался в версиях ASP.NET ранее ASP.NET 4.
Static Значение ClientID присваивается значению ID свойства. Если элемент управления является контейнером именования, элемент управления используется в верхней части иерархии контейнеров именования для всех элементов управления, содержащихся в нем.
Predictable Этот алгоритм используется для элементов управления, которые находятся в элементах управления с привязкой к данным. Это ClientID значение создается путем объединения ClientID значения родительского контейнера именования со ID значением элемента управления. Если элемент управления является элементом управления с привязкой к данным, который создает несколько строк, значение поля данных, указанного в ClientIDRowSuffix свойстве, добавляется в конце. GridView Для элемента управления можно указать несколько полей данных. ClientIDRowSuffix Если свойство пусто, то последовательное число добавляется в конце вместо значения поля данных. Это число начинается с нуля и увеличивается на 1 для каждой строки. Каждый сегмент отделяется символом подчеркивания (_).
Inherit Элемент управления наследует ClientIDMode параметр его NamingContainer элемента управления.

Значение ClientIDMode по умолчанию для страницы Predictable. Значением ClientIDMode по умолчанию для элемента управления является Inherit. Так как по умолчанию для элементов управления используется InheritPredictableрежим создания по умолчанию. (Однако если вы используете Visual Studio для преобразования веб-проекта в ASP.NET 4 из более ранней версии, Visual Studio автоматически устанавливает сайт по умолчанию AutoID в файле Web.config.)

Дополнительные сведения см. в разделе Идентификация веб-серверных элементов управления ASP.NET.

Применяется к

См. также раздел