Condividi tramite

Control.ClientIDMode Proprietà

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà .

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; }
[<System.Web.UI.Themeable(false)>]
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set
Public Overridable Property ClientIDMode As ClientIDMode

Valore della proprietà

ClientIDMode

Valore che indica come viene generata la ClientID proprietà. Il valore predefinito è Inherit.

Attributi
ThemeableAttribute

Esempio

Nell'esempio seguente vengono illustrati Label i controlli contenuti in un ListView controllo . ListView Nel controllo la ClientIDMode proprietà è impostata su Predictable e la ClientIDRowSuffix proprietà è impostata su ProductID. Nel codice HTML sottoposto a rendering vengono creati tre span elementi che corrispondono a tre ProductIDLabel controlli. Quando viene eseguita la pagina, gli id attributi per gli span elementi vengono impostati sui valori seguenti:

  • ListView1_ProductIDLabel_1
  • ListView1_ProductIDLabel_34
  • ListView1_ProductIDLabel_43
<asp:XmlDataSource ID="XmlDataSource1" runat="server" 
                   XPath="Products/Product">
  <Data>
    <Products>
      <Product ProductID="1"  ProductName="Chai" />
      <Product ProductID="34" ProductName="Ale" />
      <Product ProductID="43" ProductName="Coffee" />
    </Products>
  </Data>
</asp:XmlDataSource>

<asp:ListView ID="ListView1" 
              ClientIDMode="Predictable" 
              ClientIDRowSuffix="ProductID"  
              DataSourceID="XmlDataSource1" runat="server" >
  <ItemTemplate>
    ProductID: 
    <asp:Label ID="ProductIDLabel" runat="server" 
               Text='<%# Eval("ProductID") %>' />
    <br />
    ProductName:
    <asp:Label ID="ProductNameLabel" runat="server" 
               Text='<%# Eval("ProductName") %>' />
    <br />
    <br />
  </ItemTemplate>

  <LayoutTemplate>
    <div ID="itemPlaceholderContainer" runat="server">
      <span ID="itemPlaceholder" runat="server" />
    </div>
    <div>
    </div>
  </LayoutTemplate>
  
</asp:ListView>

Commenti

ASP.NET fornisce più algoritmi per la generazione del valore della ClientID proprietà. Selezionare l'algoritmo da utilizzare per un controllo impostandone la ClientIDMode proprietà. Gli algoritmi sono identificati dai ClientIDMode valori di enumerazione elencati nella tabella seguente.

Valore Descrizione
AutoID Il ClientID valore viene generato concatenando i ID valori di ogni contenitore di denominazione padre con il ID valore del controllo. Negli scenari di data binding in cui viene eseguito il rendering di più istanze di un controllo, viene inserito un valore di incremento davanti al valore del ID controllo. Ogni segmento è separato da un carattere di sottolineatura (_). Questo algoritmo è stato usato nelle versioni di ASP.NET precedenti a ASP.NET 4.
Static Il ClientID valore viene impostato sul valore della ID proprietà . Se il controllo è un contenitore di denominazione, il controllo viene usato come parte superiore della gerarchia dei contenitori di denominazione per tutti i controlli in esso contenuti.
Predictable Questo algoritmo viene usato per i controlli inclusi nei controlli associati a dati. Il ClientID valore viene generato concatenando il ClientID valore del contenitore di denominazione padre con il ID valore del controllo. Se il controllo è un controllo associato a dati che genera più righe, il valore del campo dati specificato nella ClientIDRowSuffix proprietà viene aggiunto alla fine. Per il GridView controllo è possibile specificare più campi dati. Se la ClientIDRowSuffix proprietà è vuota, alla fine viene aggiunto un numero sequenziale anziché un valore di campo dati. Questo numero inizia a zero e viene incrementato di 1 per ogni riga. Ogni segmento è separato da un carattere di sottolineatura (_).
Inherit Il controllo eredita l'impostazione ClientIDMode del relativo NamingContainer controllo.

Il valore predefinito di ClientIDMode per una pagina è Predictable. Il valore predefinito di ClientIDMode per un controllo è Inherit. Poiché il valore predefinito per i controlli è Inherit, la modalità di generazione predefinita è Predictable. Se tuttavia si usa Visual Studio per convertire un progetto Web in ASP.NET 4 da una versione precedente, Visual Studio imposta automaticamente il valore predefinito AutoID del sito nel file Web.config.

Per ulteriori informazioni, vedere Identificazione del controllo del server Web ASP.NET.

Si applica a

Vedi anche