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-Editor-Blatt 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.ExpressionEditorSheet
Public Overridable Function GetExpressionEditorSheet (expression As String, serviceProvider As IServiceProvider) As ExpressionEditorSheet
Parameter
- expression
- String
Der Ausdruckszeichenfolgensatz für eine Steuerelementeigenschaft, die zum Initialisieren des Ausdrucks-Editor-Blatts verwendet wird.
- serviceProvider
- IServiceProvider
Eine vom Designerhost bereitgestellte Dienstanbieterimplementierung, die zum Abrufen zusätzlicher Entwurfszeitdienste verwendet wird.
Gibt zurück
Ein ExpressionEditorSheet Element, 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-Editor-Blatt 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 überschreiben, 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 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 ResourceExpressionEditor.GetExpressionEditorSheet Methode gibt einen ResourceExpressionEditorSheet, der die einzelnen Eigenschaften definiert, die einen Ressourcenverweisausdruck bilden.
Hinweise für Vererber
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. Obwohl die Konfigurationsdatei das Präfix definiert, sollten Sie auch ein ExpressionPrefixAttribute Objekt und ein 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-Editor-Typ 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. Dient expression zum Festlegen der Anfangswerte für die Ausdruckseigenschaften. Dient serviceProvider zum Initialisieren eines benutzerdefinierten Ausdrucksblattkonstruktors und für den Zugriff auf Dienste, 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.