ExpressionEditorSheet Classe

Définition

Espace de noms:

System.Web.UI.Design

Assembly:

System.Design.dll

Représente une feuille d’éditeur au moment du design pour une expression personnalisée. Cette classe doit être héritée.

public ref class ExpressionEditorSheet abstract

public abstract class ExpressionEditorSheet

type ExpressionEditorSheet = class

Public MustInherit Class ExpressionEditorSheet

Héritage

Object

ExpressionEditorSheet

Dérivé

System.Web.UI.Design.ResourceExpressionEditorSheet

System.Web.UI.Design.RouteUrlExpressionEditorSheet

System.Web.UI.Design.RouteValueExpressionEditorSheet

Remarques

Une feuille d’éditeur d’expressions personnalisées permet aux développeurs de définir des propriétés sur une expression personnalisée au moment du design. Les valeurs de propriété de contrôle peuvent être définies à l’aide de chaînes d’expression ; les chaînes d’expression sont évaluées au moment de l’exécution par un générateur d’expressions et au moment du design par un éditeur d’expression.

Lorsque vous parcourez la Expressions propriété 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 des expressions qui fournissent la valeur 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 un préfixe d’expression dans la liste, le concepteur visuel utilise les objets et ExpressionEditorSheet les associés ExpressionEditor pour évaluer et convertir la chaîne d’expression en fonction de la syntaxe de ce type d’expression. Le concepteur visuel utilise les propriétés de la feuille de l’éditeur d’expressions pour demander une ou plusieurs chaînes qui se combinent dans la chaîne d’expression personnalisée.

En règle générale, pour fournir un nouveau type d’expression au moment du design, vous définissez un préfixe d’expression unique et fournissez des implémentations et ExpressionEditor personnaliséesExpressionBuilder. Si vous le souhaitez, vous pouvez fournir une implémentation personnalisée ExpressionEditorSheet qui définit les propriétés utilisées pour former l’expression. Pour associer un préfixe d’expression à un générateur d’expressions et un éditeur d’expressions, appliquez l’attribut ExpressionEditorAttribute et un ExpressionPrefixAttribute attribut à la classe personnalisée ExpressionBuilder , puis configurez le préfixe d’expression pour un générateur d’expressions dans l’élément expressionBuilders du fichier de configuration Web.

L’implémentation par défaut de la GetExpressionEditorSheet méthode retourne une feuille d’éditeur de base, qui utilise une chaîne d’entrée unique pour former l’expression. Les éditeurs d’expressions personnalisées dérivés de la ExpressionEditor méthode peuvent remplacer la GetExpressionEditorSheet méthode pour retourner une implémentation de feuille d’éditeur personnalisée. En règle générale, une feuille d’éditeur personnalisée contient plusieurs propriétés utilisées pour générer la chaîne d’expression. La GetExpression méthode retourne la chaîne d’expression résultante en fonction des propriétés d’expression actuelles.

Par exemple, la ResourceExpressionEditor classe dérive de la ExpressionEditor classe et fournit une implémentation permettant d’évaluer et d’associer une référence de chaîne de ressource à une propriété de contrôle au moment du design. La ResourceExpressionBuilder classe est associée au préfixe Resources d’expression et à l’implémentation ResourceExpressionEditor . La GetExpressionEditorSheet méthode retourne un ResourceExpressionEditorSheet, qui définit les propriétés individuelles qui forment une expression de référence de ressource.

Lorsque vous héritez de la ExpressionEditorSheet classe, vous devez remplacer les membres suivants :

• Méthode GetExpressionEditorSheet permettant de retourner une implémentation de feuille d’éditeur personnalisée.

• Constructeur ExpressionEditorSheet pour implémenter des actions d’initialisation personnalisées pour l’implémentation de la feuille de l’éditeur d’expression.

Notes pour les responsables de l’implémentation

Dérivez une feuille d’éditeur d’expression personnalisée de la ExpressionEditorSheet classe, si vous définissez un nouveau type d’expression pour les valeurs de propriété de contrôle et que vous souhaitez générer la chaîne d’expression en fonction de plusieurs valeurs de propriété d’expression. Une implémentation de classe dérivée doit contenir les éléments suivants :

• Propriété publique pour chaque valeur distincte dans la chaîne d’expression qui peut être définie au moment du design.

• Implémentation de la GetExpression() méthode qui forme la chaîne d’expression personnalisée à partir des valeurs de propriété de la feuille d’éditeur.

• Éventuellement, implémentation d’un constructeur qui définit les valeurs initiales des propriétés de la feuille d’éditeur.

La classe d’éditeur d’expressions personnalisées associée crée une instance de la feuille d’éditeur dérivée dans la GetExpressionEditorSheet(String, IServiceProvider) méthode, initialise cette instance avec la chaîne d’expression actuelle définie pour la propriété de contrôle et retourne l’instance au concepteur visuel. Le concepteur visuel vous permet de définir les propriétés de la feuille d’expression, puis appelle la GetExpression() méthode pour former la chaîne d’expression à partir des valeurs de propriété de la feuille d’expression d’entrée.

Constructeurs

Nom	Description
ExpressionEditorSheet(IServiceProvider)	Initialise une nouvelle instance de la classe ExpressionEditorSheet.

Propriétés

Nom	Description
IsValid	Obtient une valeur qui indique si la chaîne d’expression est valide.
ServiceProvider	Obtient l’implémentation du fournisseur de services utilisée par la feuille de l’éditeur d’expression.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetExpression()	En cas de substitution dans une classe dérivée, retourne la chaîne d’expression formée par les valeurs de propriété de la feuille de l’éditeur d’expression.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• ExpressionEditor
• GetExpressionEditorSheet(String, IServiceProvider)
• ResourceExpressionEditorSheet