ClientIDMode ClientIDMode ClientIDMode ClientIDMode Enum

Определение

Указывает способ формирования платформой ASP.NET свойства ClientID для элемента управления, к которому возможен доступ из клиентского скрипта.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
Наследование

Поля

AutoID AutoID AutoID AutoID 1

Значение свойства ClientID формируется путем сцепления значений свойства ID каждого из родительских контейнеров именования со значением свойства ID элемента управления.The ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. В сценариях с привязкой данных, где отрисовывается несколько экземпляров элемента управления, перед значением свойства 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. Все сегменты разделяются символом подчеркивания ().Each segment is separated by an underscore character (). Это был единственный алгоритм, доступный в версиях ASP.NET ранее ASP.NET 4.This algorithm is the only one that was available in versions of ASP.NET earlier than ASP.NET 4.

Inherit Inherit Inherit Inherit 0

Элемент управления наследует значение ClientIDMode от элемента управления NamingContainer.The control inherits the ClientIDMode setting of its NamingContainer control.

Predictable Predictable Predictable Predictable 2

Этот алгоритм используется для элементов управления, содержащихся в элементах управления с привязкой к данным.This algorithm is used for controls that are in data-bound controls. Значение свойства ClientID формируется путем сцепления значения свойства ClientID родительского контейнера именования со значением свойства ID элемента управления.The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. Если элемент управления представляет собой элемент управления с привязкой к данным, формирующий несколько строк, в конец идентификатора добавляется значение поля данных, указанного в свойстве ClientIDRowSuffix.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. Для элемента управления GridView может быть указано несколько полей данных.For the GridView control, multiple data fields can be specified. Если свойство ClientIDRowSuffix является пустым, в конец идентификатора вместо значения поля данных добавляется порядковый номер.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data field value. Все сегменты разделяются символом подчеркивания ().Each segment is separated by an underscore character ().

Static Static Static Static 3

Значение свойства ClientID задается равным значению свойства ID.The ClientID value is set to the value of the ID property. Если элемент управления представляет собой контейнер именования, он выступает в качестве верхнего уровня иерархии контейнеров именования для всех элементов управления, которые он содержит.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.

Примеры

В следующем примере показаны Label элементы управления, содержащиеся ListView в элементе управления.The following example shows Label controls that are contained in a ListView control. В элементе управления ClientIDMode свойство имеет значение прогнозируемое, а ClientIDRowSuffix свойству — значение ProductID. ListViewOn the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. Из клиентского скрипта можно получить доступ к определенному экземпляру Label в на основе ProductID значения экземпляра, к которому вы пытаетесь получить доступ.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.

В этом примере создается HTML с ProductIDLabel тремя элементами управления.This example creates HTML with three ProductIDLabel controls. При запуске страницы идентификаторы элементов управления будут следующими:When the page runs, the IDs for the controls will be the following:

  • ListView1_ProductIDLabel_1

  • ListView1_ProductIDLabel_34

  • ListView1_ProductIDLabel_43

Дополнительные сведения см. в разделе ASP.NET Web Server Control Identification .For more information, see ASP.NET Web Server Control Identification

Комментарии

ClientIDMode Перечисление используется при ClientIDMode задании свойства для элемента управления.You use the ClientIDMode enumeration when you set the ClientIDMode property for a control. Значение, присваиваемое ClientIDMode свойству, определяет ClientID способ создания свойства.The value that you assign to the ClientIDMode property determines how the ClientID property is generated. Значение ClientID свойства отображается id как атрибут в разметке и является значением, используемым для доступа к элементу управления из клиентского скрипта.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. Значение, присваиваемое ClientIDMode свойству, не ID влияет на свойство серверного элемента управления, а только на id атрибут соответствующего 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.

Значение по умолчанию ClientIDMode для страницы является прогнозируемым.The default value of ClientIDMode for a page is Predictable. Значение по умолчанию ClientIDMode для элемента управления — Inherit.The default value of ClientIDMode for a control is Inherit.

Поскольку по умолчанию для элементов управления наследуется, режим создания по умолчанию является прогнозируемым.Because the default for controls is Inherit, the default generation mode is Predictable. (Однако, если вы используете Visual Studio для преобразования веб-проекта в ASP.NET 4 из более ранней версии, Visual Studio автоматически устанавливает для сайта по умолчанию значение AutoID в файле 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.)

Можно задать ClientIDMode значение для всех страниц веб-сайта, задав элемент pages в файле Web. config сайта.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. Можно задать ClientIDMode значение для страницы в директиве @ Page .You can set the ClientIDMode value for a page in the @ Page directive.

Дополнительные сведения см. в разделе Идентификация элементов управления Web Forms.For more information, see ASP.NET Web Server Control Identification.

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

Дополнительно