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

Articolo
05/27/2012

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

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

Questo elemento è nuovo in .NET Framework versione 2.0.

<add
   assembly="assembly"
   namespace="namespace"
   src="file path"
   tagName="tag name"
   tagPrefix="tag prefix"
>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
assembly	Attributo String facoltativo. Specifica il nome dell'assembly contenente l'implementazione del controllo COM e richiede che venga impostato anche l'attributo namespace.
namespace	Attributo String facoltativo. Specifica lo spazio dei nomi associato al prefisso di tag e richiede che venga impostato anche l'attributo assembly, se il controllo COM non si trova nella directory del codice dell'applicazione.
src	Attributo String facoltativo. Specifica il nome del file contenente il controllo utente e richiede che venga impostato anche l'attributo tagName.
tagName	Attributo String facoltativo. Specifica il nome del controllo da utilizzare nella pagina e richiede che venga impostato anche l'attributo src.
tagPrefix	Attributo String obbligatorio. Specifica il prefisso di tag mappato a un file di origine o allo spazio dei nomi e all'assembly. L'attributo richiede una delle seguenti combinazioni di altri attributi: namespace, per definire un controllo COM, se il controllo si trova nella directory del codice dell'applicazione. namespace e assembly, per definire un controllo COM. tagName e src, per definire un controllo utente.
Attributi ereditati	Attributi facoltativi. Attributi ereditati da tutti gli elementi della sezione.

Elementi figlio

Nessuno.

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 le impostazioni di configurazione specifiche delle pagine, quali le direttive globali ASP.NET per le pagine e i controlli nell'ambito del file di configurazione.
controls	Definisce una raccolta di direttive register e gli spazi dei nomi in cui si trovano i prefissi di tag.

Note

L'elemento add aggiunge un prefisso di tag alla raccolta di prefissi di tag nell'elemento controls, utilizzati durante la precompilazione.

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" 
            src="controls/MyControl.ascx"/>
      </controls>
   </pages>

Informazioni sull'elemento

Gestore della sezione di configurazione	PagesSection
Membro di configurazione	Add
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 2005

Vedere anche

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

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive