ExpressionEditorSheet Klasse

  • Referenz

Definition

Namespace:
System.Web.UI.Design
Assembly:
System.Design.dll

Stellt ein Entwurfszeit-Editorblatt für einen benutzerdefinierten Ausdruck dar. Die Klasse muss geerbt werden.

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

Hinweise

Mit einem Blatt mit einem benutzerdefinierten Ausdrucks-Editor 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 nach einem Steuerelement im Raster der Entwurfszeiteigenschaften 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 und ExpressionEditorSheet , um die Ausdruckszeichenfolge basierend auf der Syntax für diesen Ausdruckstyp auszuwerten und zu konvertieren. Der visuelle Designer verwendet Ausdrucks-Editor-Blatteigenschaften, um zur Eingabe einer oder mehrerer Zeichenfolgen aufzufordern, die sich in der benutzerdefinierten Ausdruckszeichenfolge kombinieren.

Um zur Entwurfszeit einen neuen Ausdruckstyp bereitzustellen, definieren Sie in der Regel 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 Editor-Blatt zurück, das eine einzelne Eingabezeichenfolge verwendet, um den Ausdruck zu bilden. Benutzerdefinierte Ausdrucks-Editoren, die von der ExpressionEditor abgeleitet sind, können die GetExpressionEditorSheet -Methode überschreiben, um eine Implementierung eines benutzerdefinierten Editor-Blatts 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 leitet sich beispielsweise ResourceExpressionEditor von der ExpressionEditor -Klasse ab und stellt eine Implementierung zum Bewerten und Zuordnen eines Ressourcenzeichenfolgenverweiss zu einer Steuerelementeigenschaft zur Entwurfszeit bereit. Die ResourceExpressionBuilder -Klasse ist dem Ausdruckspräfix Resources und der ResourceExpressionEditor Implementierung zugeordnet. Die GetExpressionEditorSheet -Methode gibt einen ResourceExpressionEditorSheetzurück, der die einzelnen Eigenschaften definiert, die einen Ressourcenverweisausdruck bilden.

Wenn Sie von der -Klasse erben ExpressionEditorSheet , müssen Sie die folgenden Member überschreiben:

  • Die GetExpressionEditorSheet Methode zum Zurückgeben einer Implementierung eines benutzerdefinierten Editor-Blatts.

  • Der ExpressionEditorSheet Konstruktor zum Implementieren benutzerdefinierter Initialisierungsaktionen für ihre Ausdrucks-Editor-Blattimplementierung.

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 eindeutigen Wert in der Ausdruckszeichenfolge, die zur Entwurfszeit festgelegt werden kann.

  • Eine Implementierung der Methode, die GetExpression() die benutzerdefinierte Ausdruckszeichenfolge aus den Eigenschaftenwerten des Editor-Blatts bildet.

  • Optional eine Konstruktorimplementierung, die die Anfangswerte der Eigenschaften des Editor-Blatts 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 der aktuellen Ausdruckszeichenfolge, die für die Steuerelementeigenschaft festgelegt ist, 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

ExpressionEditorSheet(IServiceProvider)

Initialisiert eine neue Instanz der ExpressionEditorSheet-Klasse.

Eigenschaften

IsValid

Ruft einen Wert ab, der angibt, ob die Ausdruckszeichenfolge gültig ist.
ServiceProvider

Ruft die vom Ausdrucks-Editorblatt verwendete Dienstanbieterimplementierung ab.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetExpression()

Gibt beim Überschreiben in einer abgeleiteten Klasse die Ausdruckszeichenfolge zurück, die durch die Eigenschaftswerte des Ausdrucks-Editorblattes gebildet wird.
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen