ClientIDMode ClientIDMode ClientIDMode ClientIDMode Enum

Definición

Especifica cómo genera ASP.NET el ClientID para un control al que se puede obtener acceso en un script de cliente.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
Herencia

Campos

AutoID AutoID AutoID AutoID 1

El valor ClientID se genera mediante la concatenación de los valores ID de cada contenedor de nomenclatura primario con el valor ID del control.The ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. En escenarios de enlace de datos donde se presentan varias instancias de un control, se inserta un valor de incremento delante del valor ID del control.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. Un carácter de subrayado () separa cada segmento.Each segment is separated by an underscore character (). Este algoritmo es el único que estaba disponible en las versiones anteriores a 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

El control hereda la configuración de ClientIDMode de este control NamingContainer.The control inherits the ClientIDMode setting of its NamingContainer control.

Predictable Predictable Predictable Predictable 2

Este algoritmo se utiliza para los controles que están en controles enlazados a datos.This algorithm is used for controls that are in data-bound controls. El valor ClientID se genera mediante la concatenación del valor ClientID del contenedor de nomenclatura primario con el valor ID del control.The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. Si se trata de un control enlazado a datos que genera varias filas, el valor del campo de datos especificado en la propiedad ClientIDRowSuffix se agrega al final.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. En el caso del control GridView se pueden especificar varios campos de datos.For the GridView control, multiple data fields can be specified. Si la propiedad ClientIDRowSuffix está en blanco, se agrega un número secuencial al final en lugar de un valor de campo de datos.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data field value. Un carácter de subrayado () separa cada segmento.Each segment is separated by an underscore character ().

Static Static Static Static 3

El valor de ClientID se establece en el valor de la propiedad ID.The ClientID value is set to the value of the ID property. Si el control es un contenedor de nomenclatura, se utiliza como la parte superior de la jerarquía de contenedores de nomenclatura para cualquier control que contenga.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.

Ejemplos

En el ejemplo siguiente Label se muestran los controles contenidos en ListView un control.The following example shows Label controls that are contained in a ListView control. En el ListView control, la ClientIDMode propiedad se establece en predecible y la ClientIDRowSuffix propiedad se establece en ProductID.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. Desde el script de cliente, puede tener acceso a una instancia Label determinada de un ProductID según el valor de la instancia a la que está intentando obtener acceso.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.

En este ejemplo se crea HTML ProductIDLabel con tres controles.This example creates HTML with three ProductIDLabel controls. Cuando se ejecute la página, los identificadores de los controles serán los siguientes:When the page runs, the IDs for the controls will be the following:

  • ListView1_ProductIDLabel_1

  • ListView1_ProductIDLabel_34

  • ListView1_ProductIDLabel_43

Para obtener más información, vea identificación del control de servidor Web ASP.netFor more information, see ASP.NET Web Server Control Identification

Comentarios

La ClientIDMode enumeración se usa cuando se establece ClientIDMode la propiedad de un control.You use the ClientIDMode enumeration when you set the ClientIDMode property for a control. El valor que se asigna a la ClientIDMode propiedad determina cómo se ClientID genera la propiedad.The value that you assign to the ClientIDMode property determines how the ClientID property is generated. El valor de la ClientID propiedad se representa como el atributo id en el marcado y es el valor que se usa para tener acceso al control desde el script de cliente.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. El valor que se asigna a la ClientIDMode propiedad no afecta a la ID propiedad del control de servidor, solo al id atributo del elemento HTML correspondiente.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.

El valor predeterminado de ClientIDMode para una página es predecible.The default value of ClientIDMode for a page is Predictable. El valor predeterminado de ClientIDMode para un control es heredar.The default value of ClientIDMode for a control is Inherit.

Dado que el valor predeterminado para los controles es heredar, el modo de generación predeterminado es predecible.Because the default for controls is Inherit, the default generation mode is Predictable. (Sin embargo, si usa Visual Studio para convertir un proyecto web en ASP.NET 4 de una versión anterior, Visual Studio establece automáticamente el valor predeterminado del sitio en AutoID en el archivo 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.)

Puede establecer el ClientIDMode valor de todas las páginas de un sitio web estableciendo el elemento pages en el archivo Web. config del sitio.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. Puede establecer el ClientIDMode valor de una página en la directiva @ Page .You can set the ClientIDMode value for a page in the @ Page directive.

Para obtener más información, vea Identificación de controles de formularios Web Forms.For more information, see ASP.NET Web Server Control Identification.

Se aplica a

Consulte también: