expressionBuilders, élément de compilation (Schéma des paramètres ASP.NET)
Mise à jour : novembre 2007
Définit une collection de chaînes de ressources à utiliser pendant la compilation. Les chaînes de ressources associent des préfixes à des générateurs d'expressions.
Cet élément est une nouveauté du .NET Framework version 2.0.
<configuration>, élément
system.web, élément (Schéma des paramètres ASP.NET)
compilation, élément (Schéma des paramètres ASP.NET)
assemblies, élément de compilation (Schéma des paramètres ASP.NET)
<expressionBuilders>
<add />
<clear/>
<remove />
</expressionBuilders>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Aucun
Éléments enfants
Sous-balise |
Description |
|---|---|
add |
Élément facultatif. Ajoute à la collection une référence à un générateur d'expressions. |
clear |
Élément facultatif. Supprime toutes les références aux générateurs d'expression hérités, n'autorisant que celles qui sont ajoutées par l'élément add actuel. |
remove |
Élément facultatif. Supprime de la collection une référence à un générateur d'expressions hérité. |
Éléments parents
Élément |
Description |
|---|---|
configuration |
Spécifie l'élément racine dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework. |
system.web |
Spécifie l'élément racine de la section de configuration ASP.NET. |
compilation |
Configure tous les paramètres de compilation qu'ASP.NET utilise pour compiler des applications. |
Notes
L'élément expressionBuilders définit une collection de chaînes de ressources à utiliser pendant la compilation. Les chaînes de ressources associent des préfixes à des générateurs d'expressions.
Lorsque l'analyseur de pages rencontre, dans une page .aspx, une expression délimitée par la chaîne <%$ %>, il crée pour cette expression un générateur d'expressions sur la base du préfixe de la chaîne. Le préfixe est la partie de la chaîne qui est à gauche des deux-points (:). Par exemple, lorsque l'analyseur rencontre la chaîne <%$ ConnectionStrings:MessageDB %>, il crée un objet ConnectionStringsExpressionBuilder. Pour plus d'informations, consultez ExpressionBuilder.
Configuration par défaut
L'élément expressionBuilders par défaut suivant n'est pas configuré explicitement dans le fichier Machine.config ou dans le fichier Web.config racine. Toutefois, il s'agit de la configuration par défaut retournée par l'application. Les éléments sont ajoutés à la collection expressionBuilders dans le fichier Web.config racine.
<expressionBuilders>
<clear />
</expressionBuilders>
L'élément expressionBuilders par défaut suivant est configuré dans le fichier Web.config racine.
<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>
Exemple
L'exemple de code suivant montre comment inscrire un générateur d'expressions personnalisé dans le fichier Web.config. Un générateur d'expressions personnalisé doit implémenter la classe abstraite ExpressionBuilder.
Pour référencer l'expression dans un fichier .aspx, utilisez la syntaxe suivante :
<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>
Informations sur les éléments
Gestionnaire de section de configuration |
|
Membre de configuration |
|
Emplacements configurables |
Machine.config Web.config racine Web.config au niveau de l'application Web.config de niveau répertoire virtuel ou physique |
Configuration requise |
Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 .NET Framework version 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005 |
Voir aussi
Tâches
Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement
Comment : verrouiller des paramètres de configuration ASP.NET
Concepts
Vue d'ensemble de la compilation ASP.NET
Vue d'ensemble de la syntaxe des pages Web ASP.NET
Hiérarchie du fichier de configuration ASP.NET et héritage
Sécurisation de la configuration ASP.NET
Scénarios de configuration ASP.NET
Référence
compilation, élément (Schéma des paramètres ASP.NET)
add, élément de expressionBuilders pour compilation (Schéma des paramètres ASP.NET)
clear, élément de expressionBuilders pour compilation (Schéma des paramètres ASP.NET)
remove, élément de expressionBuilders pour compilation (Schéma des paramètres ASP.NET)
buildProviders, élément de compilation (Schéma des paramètres ASP.NET)
codeSubDirectories, élément de compilation (Schéma des paramètres ASP.NET)
compilers, élément de compilation (Schéma des paramètres ASP.NET)
assemblies, élément de compilation (Schéma des paramètres ASP.NET)
configuration, élément (Schéma des paramètres généraux)
system.web, élément (Schéma des paramètres ASP.NET)
Autres ressources
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET
Administration de sites Web ASP.NET