ExpressionEditor.GetExpressionEditorSheet(String, IServiceProvider) Methode
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.
Gibt ein Ausdrucks-Editorblatt zurück, das dem aktuellen Ausdrucks-Editor zugeordnet ist.
public:
virtual System::Web::UI::Design::ExpressionEditorSheet ^ GetExpressionEditorSheet(System::String ^ expression, IServiceProvider ^ serviceProvider);public virtual System.Web.UI.Design.ExpressionEditorSheet GetExpressionEditorSheet (string expression, IServiceProvider serviceProvider);abstract member GetExpressionEditorSheet : string * IServiceProvider -> System.Web.UI.Design.ExpressionEditorSheet
override this.GetExpressionEditorSheet : string * IServiceProvider -> System.Web.UI.Design.ExpressionEditorSheetPublic Overridable Function GetExpressionEditorSheet (expression As String, serviceProvider As IServiceProvider) As ExpressionEditorSheetParameter
- expression
- String
Die für eine Steuerelementeigenschaft festgelegte Ausdruckszeichenfolge, mit der das Ausdrucks-Editorblatt initialisiert wird.
- serviceProvider
- IServiceProvider
Eine vom Designerhost bereitgestellte Dienstanbieterimplementierung zur Beschaffung zusätzlicher Entwurfszeitdienste.
Gibt zurück
Ein ExpressionEditorSheet, das die benutzerdefinierten Ausdruckseigenschaften definiert.
Hinweise
Die GetExpressionEditorSheet Methode gibt eine ExpressionEditorSheet Implementierung zurück, die die Zeichenfolgen definiert, die kombiniert werden, um einen benutzerdefinierten Ausdruck zu bilden. Der visuelle Designer verwendet ein Ausdrucks-Editor-Blatt, um eine oder mehrere Zeichenfolgen einzufordern, die in einem benutzerdefinierten Ausdruck kombiniert werden. Die Basisklassenmethode gibt ein Standardausdruck-Editorblatt zurück, das eine einzelne Eingabezeichenfolge verwendet, um den Ausdruck zu bilden. Das Ausdrucks-Editor-Blatt definiert das Eigenschaftenraster für den Ausdruck. Daher werden die Eigenschaften, die der Ausdrucks-Editor verfügbar macht, zu Eigenschaften, die für den Ausdruck im Dialogfeld definiert werden können.
Klassen, die von der ExpressionEditor Klasse abgeleitet werden, können optional die GetExpressionEditorSheet Methode außer Kraft setzen, um ein benutzerdefiniertes Ausdrucks-Editor-Blatt bereitzustellen. Ein benutzerdefiniertes Ausdrucks-Editor-Blatt kann Entwurfszeiteingaben für mehrere Eigenschaften zulassen, die kombiniert werden, um die Ausdruckszeichenfolge zu bilden.
Die Klasse leitet sich beispielsweise ResourceExpressionEditor von der ExpressionEditor Klasse ab und stellt eine Implementierung zum Auswerten und Zuordnen eines Ressourcenzeichenfolgenverweiss zu einer Steuerelementeigenschaft zur Entwurfszeit bereit. Die ResourceExpressionBuilder Klasse ist dem Ausdruckspräfix Resources und der ResourceExpressionEditor Implementierung zugeordnet. Die ResourceExpressionEditor.GetExpressionEditorSheet Methode gibt einen ResourceExpressionEditorSheet, der die einzelnen Eigenschaften definiert, die einen Ressourcenverweisausdruck bilden.
Hinweise für Vererber
Um einen neuen Ausdruckstyp zur Entwurfszeit bereitzustellen, 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. Obwohl die Konfigurationsdatei das Präfix definiert, sollten Sie auch ein Objekt und ein ExpressionPrefixAttribute ExpressionEditorAttribute Objekt anwenden.
Überschreiben Sie die GetExpressionEditorSheet(String, IServiceProvider) Methode, um ein Ausdrucks-Editor-Blatt zurückzugeben, das Entwurfszeiteingaben für mehrere Eigenschaften in einem benutzerdefinierten Ausdruck definiert. Wenn Sie eine Steuerelementeigenschaft und den Ausdrucks-Editortyp auswählen, ruft der visuelle Designer die GetExpressionEditorSheet(String, IServiceProvider) Methode auf und stellt dann die aktuelle Ausdruckszeichenfolge bereit, die für die Steuerelementeigenschaft festgelegt ist. Verwenden Sie expression zum Festlegen der Anfangswerte für die Ausdruckseigenschaften. Wird verwendet serviceProvider , um einen benutzerdefinierten Ausdrucksblattkonstruktor zu initialisieren und auf Dienste zuzugreifen, die vom Designerhost bereitgestellt werden. Rufen Sie beispielsweise die GetService(Type) Methode mit dem IWebApplication Typ auf Projektelemente, Dokumente oder Konfigurationsdateidetails auf, die über den visuellen Designer bereitgestellt werden.