Partager via


ExpressionEditorSheet Classe

Définition

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
ExpressionEditorSheet
Dérivé

Remarques

Une feuille d’éditeur d’expressions personnalisées permet à un développeur 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’expressions.

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 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 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 personnalisées ExpressionBuilder et ExpressionEditor . 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 dans le 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 peuvent ExpressionEditor 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 pour évaluer et associer une référence de chaîne de ressource à une propriété de contrôle au moment de la conception. 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 votre feuille d’éditeur d’expressions.

Notes pour les responsables de l’implémentation

Dérivez une feuille d’éditeur d’expressions personnalisées à partir 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 de 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 de l’éditeur.

  • Éventuellement, implémentation du 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 de l’é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’expressions, puis appelle la méthode pour former la GetExpression() chaîne d’expression à partir des valeurs de propriété de la feuille d’expression d’entrée.

Constructeurs

ExpressionEditorSheet(IServiceProvider)

Initialise une nouvelle instance de la classe ExpressionEditorSheet.

Propriétés

IsValid

Obtient une valeur qui indique si la chaîne d'expression est valide.

ServiceProvider

Obtient l'implémentation de fournisseur de services utilisée par la feuille d'éditeur d'expressions.

Méthodes

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 feuille d'éditeur d'expressions.

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 à

Voir aussi