Share via

AppSettingsExpressionBuilder Classe

  • Référence

Définition

Espace de noms:
System.Web.Compilation
Assembly:
System.Web.dll

Récupère des valeurs, comme spécifié dans une expression déclarative, de la section <appSettings> du fichier Web.config.

public ref class AppSettingsExpressionBuilder : System::Web::Compilation::ExpressionBuilder
public class AppSettingsExpressionBuilder : System.Web.Compilation.ExpressionBuilder
type AppSettingsExpressionBuilder = class
    inherit ExpressionBuilder
Public Class AppSettingsExpressionBuilder
Inherits ExpressionBuilder
Héritage
Object
ExpressionBuilder
AppSettingsExpressionBuilder

Exemples

L’exemple de code suivant montre comment récupérer une valeur de paramètres d’application dans une page qui n’est pas compilée.

<%@ Page Language="C#" CompilationMode="Never" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Noncompiled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Welcome to the 
        <asp:Literal ID="Literal1" runat="server" 
        Text="<%$ AppSettings: thisSeason %>" /> Sale!
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" CompilationMode="Never" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Noncompiled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Welcome to the 
        <asp:Literal ID="Literal1" runat="server" 
        Text="<%$ AppSettings: thisSeason %>" /> Sale!
    </div>
    </form>
</body>
</html>

Ce code récupère l’expression suivante à partir du fichier Web.config.

<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">

<appSettings>

<add key="thisSeason" value="Fall"/>

</appSettings>

</configuration>

Remarques

La AppSettingsExpressionBuilder classe fournit l’accès aux valeurs dans la <appSettings> section du fichier Web.config. La <appSettings> section du fichier Web.config contient des valeurs spécifiques à l’application dans les paires clé/valeur.

Une valeur d’application est récupérée en affectant une expression du formulaire

<%$ AppSettings: appSettingsKey %>

à une propriété dans une déclaration de contrôle. Partie de l’expression avant le signe deux-points (:) désigne le type d’expression à récupérer, et la partie après le signe deux-points signifie la clé. L’expression précédente récupère la valeur suivante à partir du fichier Web.config.

<appSettings>

<add key="appSettingsKey" value="appSettingsValue"/>

</appSettings>

Lorsque l’analyseur de page rencontre une expression avec le AppSettings préfixe, elle crée une instance de la AppSettingsExpressionBuilder classe pour gérer l’expression.

Si l’expression est rencontrée dans une page qui sera compilée, l’objet génère du AppSettingsExpressionBuilder code pour récupérer la valeur spécifiée à partir du fichier Web.config. Ce code est exécuté pendant l’exécution de la classe de page générée. Si l’expression est rencontrée dans une page qui ne sera pas compilée, l’objet AppSettingsExpressionBuilder retourne la valeur du fichier Web.config lorsque la page est analysée et exécutée.

Constructeurs

AppSettingsExpressionBuilder()

Initialise une nouvelle instance de la classe AppSettingsExpressionBuilder.

Propriétés

SupportsEvaluate

Retourne une valeur indiquant si une expression peut être évaluée dans une page qui n'est pas compilée.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)

Retourne une valeur de la section <appSettings> du fichier Web.config.
GetAppSetting(String)

Retourne une valeur de la section <appSettings> du fichier Web.config.
GetAppSetting(String, Type, String)

Retourne une valeur de la section <appSettings> du fichier Web.config avec la valeur convertie en type cible.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Retourne une expression de code utilisée pour effectuer l'assignation de propriété dans la classe de la page générée.
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ParseExpression(String, Type, ExpressionBuilderContext)

En cas de substitution dans une classe dérivée, retourne un objet qui représente l'expression analysée.

(Hérité de ExpressionBuilder)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi