ExpressionEditorSheet Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Entwurfszeit-Editor-Blatt für einen benutzerdefinierten Ausdruck dar. Diese Klasse muss geerbt werden.
public ref class ExpressionEditorSheet abstractpublic abstract class ExpressionEditorSheettype ExpressionEditorSheet = classPublic MustInherit Class ExpressionEditorSheet- Vererbung
-
ExpressionEditorSheet
- Abgeleitet
Hinweise
Mit einem benutzerdefinierten Ausdrucks-Editor-Blatt können Entwickler Eigenschaften für einen benutzerdefinierten Ausdruck zur Entwurfszeit festlegen. Steuerelementeigenschaftenwerte können mithilfe von Ausdruckszeichenfolgen festgelegt werden; die Ausdruckszeichenfolgen werden zur Laufzeit von einem Ausdrucks-Generator und zur Entwurfszeit von einem Ausdrucks-Editor ausgewertet.
Wenn Sie die Expressions Eigenschaft für ein Steuerelement im Entwurfszeiteigenschaftenraster durchsuchen, zeigt der visuelle Designer ein Dialogfeld an, um Ausdrücke festzulegen, die den Wert für eine Steuerelementeigenschaft bereitstellen. Sie können den Ausdruckstyp basierend auf einer Liste von Ausdruckspräfixen auswählen. Wenn Sie ein Ausdruckspräfix aus der Liste auswählen, verwendet der visuelle Designer die zugeordneten ExpressionEditor Objekte ExpressionEditorSheet , um die Ausdruckszeichenfolge basierend auf der Syntax für diesen Ausdruckstyp auszuwerten und zu konvertieren. Der visuelle Designer verwendet Eigenschaften des Ausdrucks-Editor-Blatts, um eine oder mehrere Zeichenfolgen einzufordern, die in der benutzerdefinierten Ausdruckszeichenfolge kombiniert werden.
Wenn Sie zur Entwurfszeit einen neuen Ausdruckstyp bereitstellen möchten, definieren Sie ein eindeutiges Ausdruckspräfix und stellen benutzerdefinierte ExpressionBuilder Und ExpressionEditor Implementierungen bereit. Optional können Sie eine benutzerdefinierte ExpressionEditorSheet Implementierung bereitstellen, die Eigenschaften definiert, die zum Bilden des Ausdrucks verwendet werden. Um ein Ausdruckspräfix einem Ausdrucks-Generator und einem Ausdrucks-Editor zuzuordnen, wenden Sie das ExpressionEditorAttribute Attribut und ein ExpressionPrefixAttribute Attribut auf die benutzerdefinierte ExpressionBuilder Klasse an, und konfigurieren Sie dann das Ausdruckspräfix für einen Ausdrucks-Generator im expressionBuilders Element in der Webkonfigurationsdatei.
Die Standardimplementierung der GetExpressionEditorSheet Methode gibt ein einfaches Editorblatt zurück, das eine einzelne Eingabezeichenfolge verwendet, um den Ausdruck zu bilden. Benutzerdefinierte Ausdrucks-Editoren, die von der ExpressionEditor Methode abgeleitet sind, können die GetExpressionEditorSheet Methode außer Kraft setzen, um eine implementierung eines benutzerdefinierten Editorblatts zurückzugeben. In der Regel enthält ein benutzerdefiniertes Editor-Blatt mehrere Eigenschaften, die zum Erstellen der Ausdruckszeichenfolge verwendet werden. Die GetExpression Methode gibt die resultierende Ausdruckszeichenfolge basierend auf den aktuellen Ausdruckseigenschaften zurück.
Die Klasse wird beispielsweise ResourceExpressionEditor von der ExpressionEditor Klasse abgeleitet und stellt eine Implementierung zum Auswerten und Zuordnen eines Ressourcenzeichenfolgenverweises zu einer Steuerelementeigenschaft zur Entwurfszeit bereit. Die ResourceExpressionBuilder Klasse ist dem Ausdruckspräfix Resources und der ResourceExpressionEditor Implementierung zugeordnet. Die GetExpressionEditorSheet Methode gibt einen ResourceExpressionEditorSheet, der die einzelnen Eigenschaften definiert, die einen Ressourcenverweisausdruck bilden.
Wenn Sie von der ExpressionEditorSheet Klasse erben, müssen Sie die folgenden Member überschreiben:
Die GetExpressionEditorSheet Methode zum Zurückgeben einer benutzerdefinierten Editorblattimplementierung.
Der ExpressionEditorSheet Konstruktor zum Implementieren von benutzerdefinierten Initialisierungsaktionen für die Implementierung des Ausdrucks-Editor-Blatts.
Hinweise für Ausführende
Leiten Sie ein benutzerdefiniertes Ausdrucks-Editor-Blatt von der ExpressionEditorSheet Klasse ab, wenn Sie einen neuen Ausdruckstyp für Steuerelementeigenschaftenwerte definieren und die Ausdruckszeichenfolge basierend auf mehreren Ausdruckseigenschaftenwerten erstellen möchten. Eine abgeleitete Klassenimplementierung sollte Folgendes enthalten:
Eine öffentliche Eigenschaft für jeden einzelnen Wert in der Ausdruckszeichenfolge, die zur Entwurfszeit festgelegt werden kann.
Eine Implementierung der GetExpression() Methode, die die benutzerdefinierte Ausdruckszeichenfolge aus den Eigenschaftswerten des Editor-Blatts bildet.
Optional eine Konstruktorimplementierung, die die Anfangswerte der Editorblatteigenschaften festlegt.
Die zugeordnete Klasse des benutzerdefinierten Ausdrucks-Editors erstellt eine Instanz des abgeleiteten Editor-Blatts in der GetExpressionEditorSheet(String, IServiceProvider) Methode, initialisiert diese Instanz mit dem aktuellen Ausdruckszeichenfolgensatz für die Steuerelementeigenschaft und gibt die Instanz an den visuellen Designer zurück. Mit dem visuellen Designer können Sie die Eigenschaften des Ausdrucksblatts festlegen und dann die GetExpression() Methode aufrufen, um die Ausdruckszeichenfolge aus den Eigenschaftenwerten des Eingabeausdrucksblatts zu bilden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| ExpressionEditorSheet(IServiceProvider) |
Initialisiert eine neue Instanz der ExpressionEditorSheet-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| IsValid |
Ruft einen Wert ab, der angibt, ob die Ausdruckszeichenfolge gültig ist. |
| ServiceProvider |
Ruft die Vom Ausdrucks-Editor-Blatt verwendete Dienstanbieterimplementierung ab. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetExpression() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Ausdruckszeichenfolge zurückgegeben, die von den Eigenschaftenwerten des Ausdrucks-Editor-Blatts gebildet wird. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
