Control.ClientIDMode Control.ClientIDMode Control.ClientIDMode Control.ClientIDMode Property

Definición

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad 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

Valor de propiedad

Valor que indica cómo se genera la propiedad ClientID.A value that indicates how the ClientID property is generated. De manera predeterminada, es Inherit.The default is Inherit.

Ejemplos

El ejemplo siguiente muestra Label controles contenidos en un ListView control.The following example shows Label controls that are contained in a ListView control. En el ListView (control), el ClientIDMode propiedad está establecida en Predictable y ClientIDRowSuffix propiedad está establecida en ProductID.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. En el HTML representado, esto crea tres span elementos que corresponden a tres ProductIDLabel controles.In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. Cuando se ejecuta la página, el id atributos para el span elementos se establecen en los siguientes valores: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

Comentarios

ASP.NET proporciona varios algoritmos generar el ClientID valor de propiedad.ASP.NET provides multiple algorithms for how to generate the ClientID property value. Seleccione el algoritmo a utilizar para un control estableciendo su ClientIDMode propiedad.You select which algorithm to use for a control by setting its ClientIDMode property. Los algoritmos se identifican mediante el ClientIDMode valores de enumeración que se muestran en la tabla siguiente.The algorithms are identified by the ClientIDMode enumeration values that are listed in the following table.

ValorValue DescripciónDescription
AutoID 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 se utilizó en versiones de ASP.NET anteriores a ASP.NET 4.This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.
Static 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.
Predictable 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 el ClientIDRowSuffix propiedad 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. Este número empieza en cero y se incrementa en 1 para cada fila.This number begins at zero and is incremented by 1 for each row. Un carácter de subrayado () separa cada segmento.Each segment is separated by an underscore character ().
Inherit El control hereda la configuración de ClientIDMode de este control NamingContainer.The control inherits the ClientIDMode setting of its NamingContainer control.

El valor predeterminado de ClientIDMode para una página es Predictable.The default value of ClientIDMode for a page is Predictable. El valor predeterminado de ClientIDMode para un control es Inherit.The default value of ClientIDMode for a control is Inherit. Dado que es el valor predeterminado para los controles Inherit, la generación predeterminada es el modo Predictable.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 desde una versión anterior, Visual Studio establece automáticamente el valor predeterminado de 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.)

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: