AppSettingsExpressionEditor Classe

Référence

Définition

Espace de noms:: System.Web.UI.Design

Assembly:: System.Design.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit des propriétés et des méthodes pour évaluer et modifier une expression de paramètre d'application dans un fichier de configuration au moment du design.

public ref class AppSettingsExpressionEditor : System::Web::UI::Design::ExpressionEditor

public class AppSettingsExpressionEditor : System.Web.UI.Design.ExpressionEditor

type AppSettingsExpressionEditor = class
    inherit ExpressionEditor

Public Class AppSettingsExpressionEditor
Inherits ExpressionEditor

Héritage: Object

ExpressionEditor
AppSettingsExpressionEditor

Exemples

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

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

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

Dans une page Web Forms, ajoutez un HyperLink contrôle.
Pour le Hyperlink contrôle, dans Propriétés, cliquez sur Expressions, puis sur le bouton de sélection (...).

La <Hyperlinkname> boîte de dialogue Expression s’affiche.
Sous Propriétés bindables, 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 l’expression AppSettingsExpressionEditor pour la NavigateUrl propriété.

La source aspx suivante montre un exemple de 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>

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

Remarques

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

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

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

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

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

Constructeurs

AppSettingsExpressionEditor()

Initialise une nouvelle instance de la classe AppSettingsExpressionEditor.

Propriétés

ExpressionPrefix

Obtient le préfixe d'expression qui identifie des chaînes d'expressions prises en charge par l'implémentation d'éditeur d'expressions.

(Hérité de ExpressionEditor)

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
EvaluateExpression(String, Object, Type, IServiceProvider)	Évalue une chaîne d'expression de paramètre d'application et fournit la valeur au moment du design d'une propriété du contrôle.
GetExpressionEditorSheet(String, IServiceProvider)	Retourne une feuille d'éditeur d'expression pour une expression de paramètre d'application.
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)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à

Partager via