Elemento add per expressionBuilders per compilation (schema delle impostazioni ASP.NET)
Aggiunge all'insieme un riferimento a un generatore di espressioni.
Questo elemento è nuovo in .NET Framework versione 2.0.
<add
expressionPrefix = "prefix"
type = "type"
/>
Attributi ed elementi
Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.
Attributi
Attributo |
Descrizione |
|---|---|
expressionPrefix |
Attributo String obbligatorio. Specifica il prefisso per l'espressione. Questa stringa è la parte sinistra di un'espressione visualizzata in una pagina ASPX, ad esempio: <asp:Label ID="Label1" runat="server" Text="<%$ MyCustomExpression:Hello, world! %>" /> Si tratta della chiave dell'insieme. Il valore predefinito è una stringa vuota (""). |
type |
Attributo String obbligatorio. Specifica il nome della classe del generatore di espressioni che gestisce questa espressione. Può trattarsi di una classe personalizzata derivante dalla classe ExpressionBuilder. Il valore predefinito è una stringa vuota (""). |
Elementi figlio
Nessuno.
Elementi padre
Elemento |
Oggetto di 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. |
expressionBuilders |
Definisce un insieme di stringhe di risorsa da utilizzare durante la compilazione. Le stringhe di risorsa consentono di associare i prefissi ai generatori di espressioni. Questo elemento è nuovo in .NET Framework versione 2.0. |
Note
L'elemento add aggiunge all'insieme un riferimento a un generatore di espressioni.
L'elemento expressionBuilders definisce un insieme di stringhe di risorsa da utilizzare durante la compilazione. Le stringhe di risorsa consentono di associare 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 della 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 radice. 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 |
|
Membro di configurazione |
|
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 impostazioni di percorso
Procedura: bloccare le impostazioni di configurazione di ASP.NET
Riferimenti
Elemento assemblies per compilation (schema delle impostazioni ASP.NET)
Elemento remove per expressionBuilders per compilation (schema delle impostazioni ASP.NET)
Elemento clear per expressionBuilders per compilation (schema delle impostazioni ASP.NET)
Elemento configuration (schema delle impostazioni generali)
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento compilation (schema delle impostazioni ASP.NET)
Concetti
Cenni preliminari sulla compilazione in ASP.NET
Modello di codice di 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
Altre risorse
Impostazioni di configurazione generali (ASP.NET)
Impostazioni di configurazione di ASP.NET
Amministrazione di siti Web ASP.NET