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

Definizione

Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà 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

Valore della proprietà

Valore che indica in che modo viene generata la proprietà ClientID.A value that indicates how the ClientID property is generated. Il valore predefinito è Inherit.The default is Inherit.

Esempi

Nell'esempio seguente vengono Label illustrati i controlli contenuti in ListView un controllo.The following example shows Label controls that are contained in a ListView control. ClientIDMode Predictable ClientIDRowSuffix Sul controllo, la proprietà è impostata su e la proprietà è impostata ProductIDsu. ListViewOn the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. Nel codice HTML sottoposto a rendering, span vengono creati tre elementi che ProductIDLabel corrispondono a tre controlli.In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. Quando la pagina viene eseguita, id gli attributi span degli elementi vengono impostati sui valori seguenti: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

Commenti

ASP.NET fornisce più algoritmi per la generazione del valore della ClientID proprietà.ASP.NET provides multiple algorithms for how to generate the ClientID property value. È possibile selezionare l'algoritmo da usare per un controllo impostandone la ClientIDMode proprietà.You select which algorithm to use for a control by setting its ClientIDMode property. Gli algoritmi sono identificati dai ClientIDMode valori di enumerazione elencati nella tabella seguente.The algorithms are identified by the ClientIDMode enumeration values that are listed in the following table.

ValueValue DescriptionDescription
AutoID Il valore ClientID viene generato tramite la concatenazione dei valori ID di ogni contenitore di denominazione padre con il valore ID del controllo.The ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. In scenari di associazione a dati in cui viene eseguito il rendering di più istanze di un controllo, viene inserito un valore incrementale davanti al valore ID del controllo.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. Ogni segmento è separato da un carattere di sottolineatura ().Each segment is separated by an underscore character (). Questo algoritmo è stato usato nelle versioni di ASP.NET precedenti a ASP.NET 4.This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.
Static Il valore ClientID è impostato sul valore della proprietà ID.The ClientID value is set to the value of the ID property. Se il controllo è un contenitore di denominazione, il controllo viene utilizzato come elemento principale della gerarchia di contenitori di denominazione per qualsiasi controllo contenuto.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 Questo algoritmo viene utilizzato per controlli inclusi in controlli associati a dati.This algorithm is used for controls that are in data-bound controls. Il valore ClientID viene generato tramite la concatenazione del valore ClientID del contenitore di denominazione padre con il valore ID del controllo.The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. Se il controllo è un controllo associato a dati che genera più righe, il valore del campo dati specificato nella proprietà ClientIDRowSuffix viene aggiunto alla fine.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. Per il controllo GridView, è possibile specificare più campi dati.For the GridView control, multiple data fields can be specified. Se la ClientIDRowSuffix proprietà è vuota, alla fine viene aggiunto un numero sequenziale anziché un valore di campo dati.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data-field value. Questo numero inizia da zero e viene incrementato di 1 per ogni riga.This number begins at zero and is incremented by 1 for each row. Ogni segmento è separato da un carattere di sottolineatura ().Each segment is separated by an underscore character ().
Inherit Il controllo eredita l'impostazione ClientIDMode del relativo controllo NamingContainer.The control inherits the ClientIDMode setting of its NamingContainer control.

Il valore predefinito di ClientIDMode per una pagina è Predictable.The default value of ClientIDMode for a page is Predictable. Il valore predefinito di ClientIDMode per un controllo è Inherit.The default value of ClientIDMode for a control is Inherit. Poiché il valore predefinito per i Inheritcontrolli è, la modalità di Predictablegenerazione predefinita è.Because the default for controls is Inherit, the default generation mode is Predictable. Tuttavia, se si usa Visual Studio per convertire un progetto Web in ASP.NET 4 da una versione precedente, Visual Studio imposta automaticamente il sito come AutoID predefinito nel file 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.)

Per altre informazioni, vedere ASP.NET Web Server Control Identification (Identificazione del controllo server Web ASP.NET).For more information, see ASP.NET Web Server Control Identification.

Si applica a

Vedi anche