ExpressionEditor.GetExpressionEditorSheet(String, IServiceProvider) Methode

Definition

Gibt ein Ausdrucks-Editorblatt zurück, das dem aktuellen Ausdrucks-Editor zugeordnet ist.Returns an expression editor sheet that is associated with the current expression editor.

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

Die für eine Steuerelementeigenschaft festgelegte Ausdruckszeichenfolge, mit der das Ausdrucks-Editorblatt initialisiert wird.The expression string set for a control property, used to initialize the expression editor sheet.

serviceProvider
IServiceProvider

Eine vom Designerhost bereitgestellte Dienstanbieterimplementierung zur Beschaffung zusätzlicher Entwurfszeitdienste.A service provider implementation supplied by the designer host, used to obtain additional design-time services.

Gibt zurück

ExpressionEditorSheet

Ein ExpressionEditorSheet, das die benutzerdefinierten Ausdruckseigenschaften definiert.An ExpressionEditorSheet that defines the custom expression properties.

Hinweise

Die- GetExpressionEditorSheet Methode gibt eine-Implementierung zurück, die die Zeichen folgen definiert, die ExpressionEditorSheet zum bilden eines benutzerdefinierten Ausdrucks kombiniert werden.The GetExpressionEditorSheet method returns an ExpressionEditorSheet implementation that defines the strings that are combined to form a custom expression. Der visuelle Designer verwendet ein Ausdrucks-Editor Blatt, um eine oder mehrere Zeichen folgen einzugeben, die zu einem benutzerdefinierten Ausdruck kombiniert werden.The visual designer uses an expression editor sheet to prompt for one or more strings that combine into a custom expression. Die Basisklassen Methode gibt ein Standardmäßiges Ausdrucks-Editor-Blatt zurück, das eine einzelne Eingabe Zeichenfolge verwendet, um den Ausdruck zu bilden.The base class method returns a default expression editor sheet, which uses a single input string to form the expression. Das Ausdrucks-Editor Blatt definiert das Eigenschaften Raster für den Ausdruck.The expression editor sheet defines the property grid for the expression. Aus diesem Grund werden die Eigenschaften, die der Ausdrucks-Editor verfügbar macht, zu Eigenschaften, die für den Ausdruck im Dialogfeld definiert werden können.Therefore, the properties that the expression editor exposes become properties that can be defined for the expression in the dialog box.

Von der-Klasse abgeleitete Klassen ExpressionEditor können optional die GetExpressionEditorSheet Methode überschreiben, um ein benutzerdefiniertes Ausdrucks-Editor Blatt bereitzustellenClasses deriving from the ExpressionEditor class optionally can override the GetExpressionEditorSheet method to provide a custom expression editor sheet. Ein benutzerdefiniertes Ausdrucks-Editor Blatt kann die Eingabe zur Entwurfszeit für mehrere Eigenschaften ermöglichen, die zusammen kombiniert werden, um die Ausdrucks Zeichenfolge zu bilden.A custom expression editor sheet can allow design-time input for multiple properties, which are combined together to form the expression string.

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- ResourceExpressionEditor.GetExpressionEditorSheet Methode gibt einen zurück ResourceExpressionEditorSheet , der die einzelnen Eigenschaften definiert, die einen Ressourcen Verweis Ausdruck bilden.The ResourceExpressionEditor.GetExpressionEditorSheet method returns a ResourceExpressionEditorSheet, which defines the individual properties that form a resource reference expression.

Hinweise für Vererber

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. Obwohl die Konfigurationsdatei das Präfix definiert, sollten Sie auch ein ExpressionPrefixAttribute -Objekt und ein- ExpressionEditorAttribute Objekt anwenden.Even though the configuration file defines the prefix, you should also apply an ExpressionPrefixAttribute object and an ExpressionEditorAttribute object.

Überschreiben GetExpressionEditorSheet(String, IServiceProvider) Sie die-Methode, um ein Ausdrucks-Editor Blatt zurückzugeben, das die Eingabe der Entwurfszeit für mehrere Eigenschaften in einem benutzerdefinierten Ausdruck definiert.Override the GetExpressionEditorSheet(String, IServiceProvider) method to return an expression editor sheet that defines design-time input for multiple properties in a custom expression. Wenn Sie eine Steuerelement Eigenschaft und den Ausdrucks-Editor-Typ auswählen, ruft der visuelle Designer die GetExpressionEditorSheet(String, IServiceProvider) -Methode auf und gibt dann die aktuelle Ausdrucks Zeichenfolge an, die für die Steuerelement Eigenschaft festgelegt ist.When you select a control property and the expression editor type, the visual designer calls the GetExpressionEditorSheet(String, IServiceProvider) method, and then supplies the current expression string that is set for the control property. Verwenden expression Sie, um die Anfangswerte für die Ausdrucks Eigenschaften festzulegen.Use expression to set the initial values for the expression properties. Verwenden serviceProvider Sie, um einen benutzerdefinierten Konstruktor für Ausdrucks Blätter zu initialisieren und auf Dienste zuzugreifen, die vom Designer Host bereitgestellt werden.Use serviceProvider to initialize a custom expression sheet constructor and to access services that are provided by the designer host. Beispielsweise können Sie die- GetService(Type) Methode mit dem-Typ aufrufen, IWebApplication um auf Projekt Elemente, Dokumente oder Konfigurationsdatei Details zuzugreifen, die über den visuellen Designer bereitgestellt werden.For example, call the GetService(Type) method with the IWebApplication type to access project items, documents, or configuration file details that are provided through the visual designer.

Gilt für:

Siehe auch