ExpressionEditorSheet Klasse

Definition

Stellt ein Entwurfszeit-Editorblatt für einen benutzerdefinierten Ausdruck dar.Represents a design-time editor sheet for a custom expression. Die Klasse muss geerbt werden.This class must be inherited.

public ref class ExpressionEditorSheet abstract
public abstract class ExpressionEditorSheet
type ExpressionEditorSheet = class
Public MustInherit Class ExpressionEditorSheet
Vererbung
ExpressionEditorSheet
Abgeleitet

Hinweise

Ein benutzerdefiniertes Ausdrucks-Editor Blatt ermöglicht Entwicklern das Festlegen von Eigenschaften für einen benutzerdefinierten Ausdruck zur Entwurfszeit.A custom expression editor sheet lets a developer set properties on a custom expression at design-time. Steuerelement Eigenschaftswerte können mit Ausdrucks Zeichenfolgen festgelegt werden. die Ausdrucks Zeichenfolgen werden zur Laufzeit von einem Ausdrucks-Generator und zur Entwurfszeit von einem Ausdrucks-Editor ausgewertet.Control property values can be set using expression strings; the expression strings are evaluated at run time by an expression builder and at design time by an expression editor.

Wenn Sie die- Expressions Eigenschaft für ein Steuerelement im Entwurfszeit Eigenschaften Raster durchsuchen, zeigt der visuelle Designer ein Dialogfeld an, in dem Ausdrücke festgelegt werden können, die den Wert für eine Steuerelement Eigenschaft bereitstellen.When you browse the Expressions property for a control in the design-time properties grid, the visual designer displays a dialog box to set expressions that provide the value for a control property. Sie können den Ausdruckstyp basierend auf einer Liste von Ausdrucks Präfixen auswählen.You can select the expression type based on a list of expression prefixes. Wenn Sie ein Ausdrucks Präfix aus der Liste auswählen, verwendet der visuelle Designer die zugeordneten ExpressionEditor -und- ExpressionEditorSheet Objekte, um die Ausdrucks Zeichenfolge basierend auf der Syntax für diesen Typ von Ausdruck auszuwerten und zu konvertieren.When you select an expression prefix from the list, the visual designer uses the associated ExpressionEditor and ExpressionEditorSheet objects to evaluate and convert the expression string based on the syntax for that type of expression. Der visuelle Designer verwendet Ausdrucks-Editor-Blatt Eigenschaften, um eine oder mehrere Zeichen folgen einzugeben, die in der benutzerdefinierten Ausdrucks Zeichenfolge kombiniert werden.The visual designer uses expression editor sheet properties to prompt for one or more strings that combine into the custom expression string.

Zum Bereitstellen eines neuen Ausdrucks Typs zur Entwurfszeit definieren Sie in der Regel ein eindeutiges Ausdrucks Präfix und stellen benutzerdefinierte ExpressionBuilder -und- ExpressionEditor Implementierungen bereit.Typically, to supply a new expression type at design time, you define a unique expression prefix and provide custom ExpressionBuilder and ExpressionEditor implementations. Optional können Sie eine benutzerdefinierte- ExpressionEditorSheet Implementierung bereitstellen, die Eigenschaften definiert, die zum bilden des Ausdrucks verwendet werden.Optionally, you can provide a custom ExpressionEditorSheet implementation that defines properties that are used to form the expression. Um ein Ausdrucks Präfix einem Ausdrucks-Generator und einem Ausdrucks-Editor zuzuordnen, wenden ExpressionEditorAttribute Sie das-Attribut und ein- ExpressionPrefixAttribute Attribut auf die benutzerdefinierte ExpressionBuilder Klasse an, und konfigurieren Sie dann das Ausdrucks Präfix für einen Ausdrucks-Generator im- expressionBuilders Element der Webkonfigurationsdatei.To associate an expression prefix with an expression builder and an expression editor, apply the ExpressionEditorAttribute attribute and an ExpressionPrefixAttribute attribute to the custom ExpressionBuilder class, and then configure the expression prefix for an expression builder in the expressionBuilders element in the Web configuration file.

Die Standard Implementierung der- GetExpressionEditorSheet Methode gibt ein einfaches Editor-Blatt zurück, das eine einzelne Eingabe Zeichenfolge verwendet, um den Ausdruck zu bilden.The default implementation of the GetExpressionEditorSheet method returns a basic editor sheet, which uses a single input string to form the expression. Benutzerdefinierte Ausdrucks-Editoren, die von abgeleitet werden, ExpressionEditor können die- GetExpressionEditorSheet Methode überschreiben, um eine benutzerdefinierte Editor-Tabelle zurückzugebenCustom expression editors that are derived from the ExpressionEditor can override the GetExpressionEditorSheet method to return a custom editor sheet implementation. In der Regel enthält ein benutzerdefiniertes Editor Blatt mehrere Eigenschaften, die zum Erstellen der Ausdrucks Zeichenfolge verwendet werden.Typically, a custom editor sheet contains multiple properties that are used to build the expression string. Die- GetExpression Methode gibt die resultierende Ausdrucks Zeichenfolge basierend auf den aktuellen Ausdrucks Eigenschaften zurück.The GetExpression method returns the resulting expression string based on the current expression properties.

Beispielsweise wird die ResourceExpressionEditor -Klasse von der ExpressionEditor -Klasse abgeleitet und stellt eine Implementierung zum Auswerten und Zuordnen eines Ressourcen Zeichen folgen Verweises zu einer Steuerelement Eigenschaft zur Entwurfszeit bereit.For example, the ResourceExpressionEditor class derives from the ExpressionEditor class and provides an implementation for evaluating and associating a resource string reference with a control property at design time. Die ResourceExpressionBuilder -Klasse ist dem Ausdrucks Präfix Resources und der- ResourceExpressionEditor Implementierung zugeordnet.The ResourceExpressionBuilder class is associated with the expression prefix Resources and the ResourceExpressionEditor implementation. Die- GetExpressionEditorSheet Methode gibt einen zurück ResourceExpressionEditorSheet , der die einzelnen Eigenschaften definiert, die einen Ressourcen Verweis Ausdruck bilden.The GetExpressionEditorSheet method returns a ResourceExpressionEditorSheet, which defines the individual properties that form a resource reference expression.

Wenn Sie von der- ExpressionEditorSheet Klasse erben, müssen Sie die folgenden Member überschreiben:When you inherit from the ExpressionEditorSheet class, you must override the following members:

  • Die GetExpressionEditorSheet Methode, die die Implementierung eines benutzerdefinierten Editor Blatts zurückgibt.The GetExpressionEditorSheet method to return a custom editor sheet implementation.

  • Der ExpressionEditorSheet Konstruktor zum Implementieren benutzerdefinierter Initialisierungs Aktionen für die Implementierung des Ausdrucks-Editor Blatts.The ExpressionEditorSheet constructor to implement custom initialization actions for your expression editor sheet implementation.

Hinweise für Ausführende

Leiten Sie ein benutzerdefiniertes Ausdrucks-Editor Blatt von der- ExpressionEditorSheet Klasse ab, wenn Sie einen neuen Ausdruckstyp für Steuerelement Eigenschaftswerte definieren und die Ausdrucks Zeichenfolge auf der Grundlage mehrerer Ausdrucks Eigenschaftswerte erstellen möchten.Derive a custom expression editor sheet from the ExpressionEditorSheet class, if you are defining a new expression type for control property values and you want to build the expression string based on multiple expression property values. Eine abgeleitete Klassen Implementierung sollte Folgendes enthalten:A derived class implementation should contain the following: : Eine öffentliche Eigenschaft für jeden eindeutigen Wert in der Ausdrucks Zeichenfolge, die zur Entwurfszeit festgelegt werden kann.- A public property for each distinct value in the expression string that can be set at design time.

-Eine Implementierung der- GetExpression() Methode, die die benutzerdefinierte Ausdrucks Zeichenfolge aus den Eigenschafts Werten der Editor-Tabelle bildet.- An implementation of the GetExpression() method that forms the custom expression string from the editor sheet property values.

: Optional eine Konstruktorimplementierung, die die Anfangswerte der Editor Blatt Eigenschaften festlegt.- Optionally, a constructor implementation that sets the initial values of the editor sheet properties.

Die zugehörige benutzerdefinierte Ausdrucks-Editor-Klasse erstellt eine Instanz des abgeleiteten Editor Blatts in der- GetExpressionEditorSheet(String, IServiceProvider) Methode, initialisiert diese Instanz mit der aktuellen Ausdrucks Zeichenfolge für die Steuerelement Eigenschaft und gibt die-Instanz an den visuellen Designer zurück.The associated custom expression editor class creates an instance of the derived editor sheet in the GetExpressionEditorSheet(String, IServiceProvider) method, initializes that instance with the current expression string set for the control property, and returns the instance to the visual designer. Mit dem visuellen Designer können Sie die Eigenschaften des Ausdrucks Blatts festlegen und dann die- GetExpression() Methode aufrufen, um die Ausdrucks Zeichenfolge aus den Eigenschafts Werten des Eingabe Ausdrucks Blatts zu bilden.The visual designer allows you to set the expression sheet properties, and then calls the GetExpression() method to form the expression string from the input expression sheet property values.

Konstruktoren

ExpressionEditorSheet(IServiceProvider)

Initialisiert eine neue Instanz der ExpressionEditorSheet-Klasse.Initializes a new instance of the ExpressionEditorSheet class.

Eigenschaften

IsValid

Ruft einen Wert ab, der angibt, ob die Ausdruckszeichenfolge gültig ist.Gets a value that indicates whether the expression string is valid.

ServiceProvider

Ruft die vom Ausdrucks-Editorblatt verwendete Dienstanbieterimplementierung ab.Gets the service provider implementation that is used by the expression editor sheet.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetExpression()

Gibt beim Überschreiben in einer abgeleiteten Klasse die Ausdruckszeichenfolge zurück, die durch die Eigenschaftswerte des Ausdrucks-Editorblattes gebildet wird.When overridden in a derived class, returns the expression string that is formed by the expression editor sheet property values.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch