System.Web.UI.Design.ExpressionEditor.GetExpressionEditorSheet Method

Returns an expression editor sheet that is associated with the current expression editor.

Syntax

public virtual ExpressionEditorSheet GetExpressionEditorSheet (string expression, IServiceProvider serviceProvider)

Parameters

expression
The expression string set for a control property, used to initialize the expression editor sheet.
serviceProvider
A service provider implementation supplied by the designer host, used to obtain additional design-time services.

Returns

An System.Web.UI.Design.ExpressionEditorSheet that defines the custom expression properties.

Remarks

The ExpressionEditor.GetExpressionEditorSheet(string, IServiceProvider) method returns an System.Web.UI.Design.ExpressionEditorSheet implementation that defines the strings that are combined to form a custom expression. The visual designer uses an expression editor sheet to prompt for one or more strings that combine into a custom expression. The base class method returns a default expression editor sheet, which uses a single input string to form the expression. The expression editor sheet defines the property grid for the expression. Therefore, the properties that the expression editor exposes become properties that can be defined for the expression in the dialog box.

Classes deriving from the System.Web.UI.Design.ExpressionEditor class optionally can override the ExpressionEditor.GetExpressionEditorSheet(string, IServiceProvider) method to provide a custom expression editor sheet. A custom expression editor sheet can allow design-time input for multiple properties, which are combined together to form the expression string.

For example, the System.Web.UI.Design.ResourceExpressionEditor class derives from the System.Web.UI.Design.ExpressionEditor class and provides an implementation for evaluating and associating a resource string reference with a control property at design time. The System.Web.Compilation.ResourceExpressionBuilder class is associated with the expression prefix Resources and the System.Web.UI.Design.ResourceExpressionEditor implementation. The ResourceExpressionEditor.GetExpressionEditorSheet(string, IServiceProvider) method returns a System.Web.UI.Design.ResourceExpressionEditorSheet, which defines the individual properties that form a resource reference expression.

Requirements

Namespace: System.Web.UI.Design
Assembly: System.Design (in System.Design.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0