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

Aggiornamento: novembre 2007

Definisce un insieme di stringhe di risorsa da utilizzare durante la compilazione. Le stringhe di risorsa associano i prefissi ai generatori di espressioni.

Questo elemento è nuovo in .NET Framework versione 2.0.

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

<expressionBuilders> 
   <add />
   <clear/>
   <remove />
</expressionBuilders>

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Sottotag

Descrizione

add

Elemento facoltativo.

Aggiunge all'insieme un riferimento a un generatore di espressioni.

clear

Elemento facoltativo.

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

remove

Elemento facoltativo.

Rimuove dall'insieme un riferimento a un generatore di espressioni 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

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

Note

L'elemento expressionBuilders definisce un insieme di stringhe di risorsa da utilizzare durante la compilazione. Le stringhe di risorsa associano i prefissi ai generatori di espressioni.

Quando il parser di pagina rileva un'espressione in una pagina aspx delimitata dalla stringa <%$ %>, crea un generatore di espressioni per l'espressione in base al prefisso della stringa. Il prefisso è la parte di stringa a sinistra dei due punti (:). Quando, ad esempio, il parser rileva la stringa <%$ ConnectionStrings:MessageDB %>, crea un oggetto ConnectionStringsExpressionBuilder. Per ulteriori informazioni, vedere ExpressionBuilder.

Configurazione predefinita

L'elemento expressionBuilders 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 expressionBuilders nel file Web.config a livello di radice.

<expressionBuilders>
   <clear />
</expressionBuilders>

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

<expressionBuilders>
   <add expressionPrefix="Resources" type="System.Web.Compilation.ResourceExpressionBuilder" />
   <add expressionPrefix="ConnectionStrings" type="System.Web.Compilation.ConnectionStringsExpressionBuilder" />
   <add expressionPrefix="AppSettings" type="System.Web.Compilation.AppSettingsExpressionBuilder" />
</expressionBuilders>

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come registrare un generatore di espressioni personalizzato nel file Web.config. Un generatore di espressioni personalizzato deve implementare la classe astratta ExpressionBuilder.

Per fare riferimento all'espressione in un file ASPX, utilizzare la seguente sintassi:

<asp:Label ID="Label1" runat="server"

Text="<%$ MyCustomExpression:Hello, world! %>" />

<configuration>
    <system.web>
       <compilation>
          <expressionBuilders>
              <add expressionPrefix="MyCustomExpression"
               type="MyCustomExpressionBuilder"/>
          </expressionBuilders>
       </compilation>
    </system.web>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione

CompilationSection

Membro di configurazione

ExpressionBuilders

ExpressionBuilderCollection

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

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 expressionBuilders per compilation (schema delle impostazioni ASP.NET)

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

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

Elemento buildProviders 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 assemblies 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

ExpressionBuilders

ExpressionBuilderCollection

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