AppSettingsExpressionEditor, classe

La classe AppSettingsExpressionEditor dérive de la classe ExpressionEditor et fournit une implémentation pour évaluer et associer une référence de paramètre d'application à une propriété du contrôle au moment du design. Par exemple, vous pouvez lier la valeur d'une propriété du contrôle à l'expression de paramètre d'application AppSettings:mySettingKeyName, ce qui indique que la valeur de la propriété du contrôle est définie à l'aide de la valeur mySettingKeyName dans la section appSettings du fichier de configuration Web.

Un hôte de concepteur visuel, tel que Visual Studio 2005, utilise la classe AppSettingsExpressionEditor pour sélectionner un paramètre d'application dans la section de configuration appSettings, puis évalue l'expression sélectionnée pour le rendu au moment du design.

Lorsque vous parcourez la propriété Expressions à la recherche d'un contrôle dans la grille des propriétés au moment du design, le concepteur visuel affiche une boîte de dialogue pour définir les expressions qui fournissent la valeur runtime pour une propriété du contrôle. Vous pouvez sélectionner le type d'expression en vous basant sur une liste de préfixes d'expression. Lorsque vous sélectionnez le préfixe d'expression AppSettings dans la liste, l'hôte de concepteur visuel utilise l'objet ExpressionEditorSheet associé pour fournir des fonctionnalités d'édition au moment du design d'expressions appSettings et il utilise des méthodes AppSettingsExpressionEditor pour évaluer et convertir la chaîne d'expression selon la syntaxe d'une expression de paramètre d'application. L'hôte de concepteur visuel utilise le résultat de l'expression évaluée pour assigner des valeurs de propriété du contrôle qui sont rendues sur l'aire de conception.

La propriété ExpressionPrefix d'un objet AppSettingsExpressionEditor retourne la chaîne AppSettings. La classe AppSettingsExpressionBuilder est associée au préfixe d'expression AppSettings et à l'implémentation AppSettingsExpressionEditor.

La méthode EvaluateExpression évalue une chaîne d'expression de paramètre d'application d'entrée. La méthode GetExpressionEditorSheet retourne l'implémentation ExpressionEditorSheet qui est utilisée pour entrer et modifier des expressions de paramètre d'application.

L'exemple de code suivant montre comment lier la propriété NavigateUrl d'un contrôle HyperLink à une expression de paramètre d'application à l'aide de l'objet AppSettingsExpressionEditor.

1. Dans un projet Web Forms, ajoutez MyHyperLinkSetting à la section <appSettings> du fichier web.config.

   None

   Copier

   
   <FileName>web.config</FileName>
   <RelevantItems>
       <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
   </RelevantItems>
   
   
   

   None

   Copier

   
   	<appSettings>
   		<add key="MyHyperLinkSetting" value="http://www.microsoft.com" />
   	</appSettings>
   
   
   

2. Dans une page Web Forms, ajoutez un contrôle HyperLink.

3. Pour le contrôle Hyperlink, dans Propriétés, cliquez sur Expressions, puis sur le bouton de sélection ( ...).

   La boîte de dialogue <Hyperlinkname>Expression s'affiche.

4. Sous Propriétés pouvant être liées, cliquez sur NavigateUrl, dans la liste Type d'expression, cliquez sur AppSettings, puis sous Propriétés d'expression, dans la zone AppSetting, tapez MyHyperLinkSetting.

Le concepteur visuel utilise AppSettingsExpressionEditor pour assigner l'expression pour la propriété NavigateUrl.

La source aspx suivante illustre une valeur de propriété définie à l'aide d'une expression de paramètre d'application.

<!-- Define a hyperlink that maps the NavigateUrl property to the
     MyHyperLinkSetting value in the Web.Config appSettings section. -->
<asp:HyperLink runat="server" ID="HyperLink1" 
     NavigateUrl="<%$ AppSettings:MyHyperLinkSetting %>">
     HyperLink using an AppSetting expression
</asp:HyperLink>

<FileName>ControlsUsingExpressions.aspx</FileName>
<RelevantItems>
    <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
</RelevantItems>

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources