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

  • Articolo

Aggiornamento: novembre 2007

Definisce un insieme 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.

Elemento configuration (schema delle impostazioni generali)
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento pages (schema delle impostazioni ASP.NET)
      Elemento controls per pages (schema delle impostazioni ASP.NET)

<controls> 
   <add /> 
</controls>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Nessuno.

Elementi figlio

Elemento

Descrizione

add

Elemento facoltativo.

Aggiunge un prefisso di tag all'insieme 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 un insieme 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à

Procedura: configurare directory specifiche utilizzando le impostazioni posizione

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Gerarchia ed ereditarietà dei file di configurazione di ASP.NET

Protezione della configurazione di ASP.NET

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

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Amministrazione di siti Web ASP.NET

API di configurazione di ASP.NET