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

ClientIDMode Перечисление

Определение

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

Указывает, как ASP.NET создает ClientID для элемента управления, доступ к которому можно получить в клиентском скрипте.

public enum class ClientIDMode
public enum ClientIDMode
type ClientIDMode = 
Public Enum ClientIDMode
Наследование
Object
ValueType
Enum
ClientIDMode

Поля

Имя Значение Описание
Inherit 0

Элемент управления наследует ClientIDMode параметр его NamingContainer элемента управления.
AutoID 1

Это ClientID значение создается путем объединения ID значений каждого родительского контейнера именования со ID значением элемента управления. В сценариях привязки данных, в которых отрисовывается несколько экземпляров элемента управления, перед значением элемента управления ID вставляется добавочное значение. Каждый сегмент отделяется символом подчеркивания (_). Этот алгоритм является единственным, который был доступен в версиях ASP.NET ранее ASP.NET 4.
Predictable 2

Этот алгоритм используется для элементов управления, которые находятся в элементах управления с привязкой к данным. Это ClientID значение создается путем объединения ClientID значения родительского контейнера именования со ID значением элемента управления. Если элемент управления является элементом управления с привязкой к данным, который создает несколько строк, значение поля данных, указанного в ClientIDRowSuffix свойстве, добавляется в конце. GridView Для элемента управления можно указать несколько полей данных. ClientIDRowSuffix Если свойство пусто, то последовательное число добавляется в конце вместо значения поля данных. Каждый сегмент отделяется символом подчеркивания (_).
Static 3

Значение ClientID присваивается значению ID свойства. Если элемент управления является контейнером именования, элемент управления используется в верхней части иерархии контейнеров именования для всех элементов управления, содержащихся в нем.

Примеры

В следующем примере показаны Label элементы управления, содержащиеся в элементе ListView управления. В элементе ListView управления свойство имеет значение "Предсказуемая", ClientIDMode а ClientIDRowSuffix для свойства задано значение ProductID. Из клиентского скрипта Label можно получить доступ к конкретному экземпляру на ProductID основе значения экземпляра, к которому вы пытаетесь получить доступ.

В этом примере создается HTML с тремя ProductIDLabel элементами управления. При запуске страницы идентификаторы элементов управления будут следующими:

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

Комментарии

При установке ClientIDMode свойства для элемента управления используется ClientIDMode перечисление. Значение, которое назначается свойству ClientIDMode , определяет, как ClientID создается свойство. Значение ClientID свойства отображается как id атрибут в разметке, и это значение, используемое для доступа к элементу управления из клиентского скрипта. Значение, присвоенное ClientIDMode свойству, не влияет на ID свойство серверного элемента управления, только id атрибут соответствующего HTML-элемента.

Значение ClientIDMode по умолчанию для страницы является предсказуемым. Значением ClientIDMode по умолчанию для элемента управления является Наследование.

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

Можно задать ClientIDMode значение для всех страниц на веб-сайте, задав элемент pages в файле Web.config сайта. Значение страницы можно задать ClientIDMode в директиве @Page .

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

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

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