Condividi tramite

ClientIDMode Enumerazione

Definizione

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

Specifica il modo in cui ASP.NET genera il ClientID per un controllo accessibile nello script client.

public enum class ClientIDMode
public enum ClientIDMode
type ClientIDMode = 
Public Enum ClientIDMode
Ereditarietà
Object
ValueType
Enum
ClientIDMode

Campi

Nome Valore Descrizione
Inherit 0

Il controllo eredita l'impostazione ClientIDMode del relativo NamingContainer controllo.
AutoID 1

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 è l'unico disponibile nelle versioni di ASP.NET precedenti a ASP.NET 4.
Predictable 2

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 del campo dati. Ogni segmento è separato da un carattere di sottolineatura (_).
Static 3

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.

Esempio

Nell'esempio seguente vengono illustrati Label i controlli contenuti in un ListView controllo . ListView Nel controllo la ClientIDMode proprietà è impostata su Stimabile e la ClientIDRowSuffix proprietà è impostata su ProductID. Dallo script client è possibile accedere a una determinata istanza di un Label oggetto in base al ProductID valore dell'istanza a cui si sta tentando di accedere.

In questo esempio viene creato codice HTML con tre ProductIDLabel controlli. Quando viene eseguita la pagina, gli ID per i controlli saranno i 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

L'enumerazione ClientIDMode viene utilizzata quando si imposta la ClientIDMode proprietà per un controllo . Il valore assegnato alla ClientIDMode proprietà determina la modalità di generazione della ClientID proprietà. Il valore della ClientID proprietà viene sottoposto a rendering come id attributo nel markup ed è il valore usato per accedere al controllo dallo script client. Il valore assegnato alla ClientIDMode proprietà non influisce sulla ID proprietà del controllo server, ma solo sull'attributo dell'elemento id HTML corrispondente.

Il valore predefinito di ClientIDMode per una pagina è Stimabile. Il valore predefinito di ClientIDMode per un controllo è Inherit.

Poiché l'impostazione predefinita per i controlli è Inherit, la modalità di generazione predefinita è Stimabile. 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.

È possibile impostare il ClientIDMode valore per tutte le pagine di un sito Web impostando l'elemento pages nel file di Web.config del sito. È possibile impostare il ClientIDMode valore per una pagina nella direttiva @ Page .

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

Si applica a

Vedi anche