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

L'esempio seguente illustra Label controlli contenuti in un ListView controllo.The following example shows Label controls that are contained in a ListView control. Nel ListView (controllo), il ClientIDMode è impostata su Predictable e il ClientIDRowSuffix viene impostata su ProductID.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. Nel codice HTML sottoposto a rendering, questo crea tre span elementi che corrispondono a tre ProductIDLabel controlli.In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. Quando si esegue la pagina, il id degli attributi per il span 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 informazioni su come generare il ClientID valore della proprietà.ASP.NET provides multiple algorithms for how to generate the ClientID property value. Si seleziona l'algoritmo da utilizzare per un controllo impostando relativo ClientIDMode proprietà.You select which algorithm to use for a control by setting its ClientIDMode property. Gli algoritmi sono identificati dal 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 DescrizioneDescription
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 ad 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 il ClientIDRowSuffix proprietà è vuota, viene aggiunto un numero sequenziale alla fine anziché un valore del 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 in corrispondenza di 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 ClientIDMode per una pagina è Predictable.The default value of ClientIDMode for a page is Predictable. Il valore predefinito ClientIDMode per un controllo è Inherit.The default value of ClientIDMode for a control is Inherit. Poiché per impostazione predefinita per i controlli Inherit, la generazione di predefinita è la modalità Predictable.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 valore predefinito del sito su AutoID 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