Elemento controls per pages (schema delle impostazioni ASP.NET)

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

Definisce una raccolta di direttive register e gli spazi dei nomi in cui si trovano i prefissi di tag.

Questo elemento è nuovo in .NET Framework versione 2.0.

<controls> 
   <add /> 
</controls>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Nessuno.

Elementi figlio

Elemento

Descrizione

add

Elemento facoltativo.

Aggiunge un prefisso di tag alla raccolta di prefissi di tag utilizzati durante la precompilazione.

Elementi padre

Elemento

Descrizione

configuration

Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione e contiene gli elementi che consentono di configurare le applicazioni Web ASP.NET e di controllarne il comportamento.

pages

Definisce globalmente le impostazioni di configurazione specifiche delle pagine, quali le direttive ASP.NET per le pagine e i controlli nell'ambito del file di configurazione.

Note

L'elemento controls definisce una raccolta di direttive register e gli spazi dei nomi in cui si trovano i prefissi di tag. Questo elemento corrisponde alla direttiva @ Register nella pagina ASP.NET. La direttiva @ Register consente di specificare il prefisso di tag per un controllo utente.

I prefissi di tag associano uno spazio dei nomi in ASP.NET agli assembly e agli spazi dei nomi che è necessario includere per il corretto funzionamento dei controlli COM e dei controlli utente. Di seguito sono riportate le informazioni utili per la configurazione dell'elemento controls.

  • Se applicati a un controllo utente, è necessario definire gli attributi tagPrefix, tagName e source dell'elemento figlio add.

  • Se applicati a un controllo personalizzato, è necessario definire gli attributi tagPrefix, namespace e assembly dell'elemento figlio add. Se il controllo si trova nella directory del codice dell'applicazione, l'attributo assembly non è necessario.

È possibile utilizzare lo stesso valore tagPrefix per eseguire il mapping a più spazi dei nomi o assembly.

Configurazione predefinita

Il seguente elemento controls predefinito viene configurato nel file Web.config a livello di radice.

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come specificare in modo dichiarativo i valori per diversi attributi dell'elemento controls a cui è possibile accedere anche a livello di codice in quanto membri della classe TagPrefixInfo.

   <pages>
      <controls>
         <!—- Searches all linked assemblies for the namespace -->
         <add 
            tagPrefix="MyTags1" 
            namespace="MyNameSpace"/>
         <!-- Uses a specified assembly -->
         <add 
            tagPrefix="MyTags2"
            namespace="MyNameSpace" 
            assembly="MyAssembly"/>
         <!-- Uses the specified source for the user control -->
         <add 
            tagPrefix="MyTags3" 
            tagName="MyCtrl" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

Informazioni sull'elemento

Gestore della sezione di configurazione

PagesSection

Membro di configurazione

Controls

TagPrefixCollection

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Web.config a livello di directory fisica o virtuale

Requisiti

Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0

.NET Framework versione 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Attività

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Riferimenti

Elemento pages (schema delle impostazioni ASP.NET)

Elemento add per controls per pages (schema delle impostazioni ASP.NET)

Elemento tagMapping per pages (schema delle impostazioni ASP.NET)

Elemento namespaces per pages (schema delle impostazioni ASP.NET)

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

Concetti

ASP.NET Configuration File Hierarchy

Securing Configuration

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API