Partager via


add, élément de expressionBuilders pour compilation (Schéma des paramètres ASP.NET)

Mise à jour : novembre 2007

Ajoute à la collection une référence à un générateur d'expressions.

Cet élément est une nouveauté de la version 2.0 du .NET Framework.

<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)
        add, élément de expressionBuilders pour compilation (Schéma des paramètres ASP.NET)

<add
   expressionPrefix = "prefix" 
   type = "type" 
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

expressionPrefix

Attribut String requis.

Spécifie le préfixe pour l'expression. Cette chaîne est la partie gauche d'une expression telle qu'elle apparaît dans une page .aspx, par exemple :

<asp:Label ID="Label1" runat="server" Text="<%$ MyCustomExpression:Hello, world! %>" />

C'est la clé de collection.

La valeur par défaut est une chaîne vide ("").

type

Attribut String requis.

Spécifie le nom de la classe de générateurs d'expressions qui gère cette expression. Il peut s'agir d'une classe personnalisée dérivée de la classe ExpressionBuilder.

La valeur par défaut est une chaîne vide ("").

Éléments enfants

Aucun.

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

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.

Cet élément est une nouveauté de la version 2.0 du .NET Framework.

Notes

L'élément add ajoute une référence à un générateur d'expressions à la collection.

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

CompilationSection

Membre de configuration

Add

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

Modèle de code 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

assemblies, élément de compilation (Schéma des paramètres ASP.NET)

remove, é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)

configuration, élément (Schéma des paramètres généraux)

system.web, élément (Schéma des paramètres ASP.NET)

compilation, élément (Schéma des paramètres ASP.NET)

System.Configuration

System.Web.Configuration

CompilationSection

Add

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

Fichiers de configuration ASP.NET

API de configuration ASP.NET