Elemento buildProviders per compilation (schema delle impostazioni ASP.NET)

Aggiornamento: novembre 2007

Definisce un insieme di provider di compilazione utilizzati per compilare file di risorse personalizzati.

Elemento <Configuration>
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento compilation (schema delle impostazioni ASP.NET)
      Elemento buildProviders per compilation (schema delle impostazioni ASP.NET)

<buildProviders> 
   <add />
   <clear/>
   <remove />
</buildProviders>

Attributi ed elementi

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

Attributi

Nessuno.

Elementi figlio

Sottotag

Descrizione

add

Elemento facoltativo.

Consente di aggiungere un provider di compilazione all'insieme.

clear

Elemento facoltativo.

Rimuove tutti i riferimenti ai provider di compilazione ereditati consentendo solo quelli aggiunti dall'elemento add corrente.

remove

Elemento facoltativo.

Consente di rimuovere dall'insieme un riferimento a un provider di compilazione ereditato.

Elementi padre

Elemento

Descrizione

configuration

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

system.web

Specifica l'elemento di primo livello per la sezione di configurazione ASP.NET.

compilation

Consente di configurare tutte le impostazioni di compilazione utilizzate in ASP.NET per compilare le applicazioni.

Note

L'elemento buildProviders definisce un insieme di provider di compilazione utilizzati per compilare i file di risorse personalizzati di un determinato tipo di file e per generare il codice durante la compilazione.

Per definire le azioni di compilazione personalizzate per un tipo di file in un'applicazione ASP.NET, è necessario derivare una classe dalla classe BuildProvider, implementare i membri nella classe derivata per compilare il tipo di file e configurare il provider di compilazione per l'estensione di file corrispondente nel file di configurazione dell'applicazione. Per informazioni, vedere BuildProvider.

Configurazione predefinita

L'elemento buildProviders predefinito riportato di seguito non viene configurato in modo esplicito nel file Machine.config o nel file Web.config principale. Si tratta, tuttavia, della configurazione predefinita restituita dall'applicazione. Gli elementi vengono aggiunti all'insieme buildProviders nel file Web.config a livello di radice.

<buildProviders>
   <clear />
</buildProviders>

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

<buildProviders>
   <add extension=".aspx" type="System.Web.Compilation.PageBuildProvider"/>
   <add extension=".ascx" type="System.Web.Compilation.UserControlBuildProvider"/>
   <add extension=".master" type="System.Web.Compilation.MasterPageBuildProvider"/>
   <add extension=".asix" type="System.Web.Compilation.ImageGeneratorBuildProvider"/>
   <add extension=".asmx" type="System.Web.Compilation.WebServiceBuildProvider"/>
   <add extension=".ashx" type="System.Web.Compilation.WebHandlerBuildProvider"/>
   <add extension=".soap" type="System.Web.Compilation.WebServiceBuildProvider"/>
   <add extension=".resx" type="System.Web.Compilation.ResXBuildProvider"/>
   <add extension=".resources" type="System.Web.Compilation.ResourcesBuildProvider"/>
   <add extension=".wsdl" type="System.Web.Compilation.WsdlBuildProvider"/>
   <add extension=".xsd" type="System.Web.Compilation.XsdBuildProvider"/>
   <add extension=".js" type="System.Web.Compilation.ForceCopyBuildProvider"/>
</buildProviders>

Esempio

Nell'esempio di codice riportato di seguito viene definito un provider di compilazione utilizzato per compilare i file di risorse personalizzati con l'estensione specificata.

<configuration>
   <system.web>
      <compilation>
         <buildProviders>
            <buildProvider 
               extension=".mafx" 
               type="MyBuildProviderType, MyBuildProviderAssembly" />
         </buildProviders>
      </compilation>
   </system.web>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione

CompilationSection

Membro di configurazione

BuildProviders

BuildProviderCollection

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 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

Cenni preliminari sulla compilazione in ASP.NET

Cenni preliminari sulla sintassi delle pagine Web ASP.NET

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

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

Elemento compilation (schema delle impostazioni ASP.NET)

Elemento add per buildProviders per compilation (schema delle impostazioni ASP.NET)

Elemento clear per buildProviders per compilation (schema delle impostazioni ASP.NET)

Elemento remove per buildProviders per compilation (schema delle impostazioni ASP.NET)

Elemento assemblies per compilation (schema delle impostazioni ASP.NET)

Elemento codeSubDirectories per compilation (schema delle impostazioni ASP.NET)

Elemento compilers per compilation (schema delle impostazioni ASP.NET)

Elemento expressionBuilders per compilation (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

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

System.Configuration

System.Web.Configuration

CompilationSection

BuildProviders

BuildProviderCollection

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Amministrazione di siti Web ASP.NET

File di configurazione ASP.NET

API di configurazione di ASP.NET