ExpressionEditorSheet 类

  • 参考

定义

命名空间:
System.Web.UI.Design
程序集:
System.Design.dll

表示自定义表达式的设计时编辑器表。 必须继承此类。

public ref class ExpressionEditorSheet abstract
public abstract class ExpressionEditorSheet
type ExpressionEditorSheet = class
Public MustInherit Class ExpressionEditorSheet
继承
Object
ExpressionEditorSheet
派生

注解

自定义表达式编辑器工作表允许开发人员在设计时设置自定义表达式的属性。 可以使用表达式字符串设置控件属性值;表达式字符串在运行时由表达式生成器计算，在设计时由表达式编辑器计算。

在设计时属性网格中浏览 Expressions 控件的属性时，可视设计器将显示一个对话框，用于设置为控件属性提供值的表达式。 可以根据表达式前缀列表选择表达式类型。 从列表中选择表达式前缀时，可视化设计器将使用关联的 ExpressionEditor 和 ExpressionEditorSheet 对象，根据该表达式类型的语法来计算和转换表达式字符串。 可视化设计器使用表达式编辑器工作表属性来提示输入合并到自定义表达式字符串中的一个或多个字符串。

通常，若要在设计时提供新的表达式类型，请定义唯一的表达式前缀并提供自定义 ExpressionBuilder 和 ExpressionEditor 实现。 （可选）可以提供定义用于构成表达式的属性的自定义 ExpressionEditorSheet 实现。 若要将表达式前缀与表达式生成器和表达式编辑器相关联，请将 属性和 ExpressionPrefixAttribute 特性应用于ExpressionEditorAttribute自定义ExpressionBuilder类，然后在 Web 配置文件的 元素中expressionBuilders为表达式生成器配置表达式前缀。

方法的默认实现 GetExpressionEditorSheet 返回基本编辑器表，该表使用单个输入字符串来构成表达式。 派生自 ExpressionEditor 的自定义表达式编辑器可以重写 GetExpressionEditorSheet 方法以返回自定义编辑器表实现。 通常，自定义编辑器表包含多个属性，这些属性用于生成表达式字符串。 方法 GetExpression 根据当前表达式属性返回生成的表达式字符串。

例如， ResourceExpressionEditor 类派生自 ExpressionEditor 类，并提供一个实现，用于在设计时评估资源字符串引用并将其与控件属性相关联。 类 ResourceExpressionBuilder 与表达式前缀 Resources 和 ResourceExpressionEditor 实现相关联。 方法 GetExpressionEditorSheet 返回 一个 ResourceExpressionEditorSheet，它定义构成资源引用表达式的各个属性。

从 ExpressionEditorSheet 类继承时，必须重写以下成员：

实施者说明

如果要为控件属性值定义新的表达式类型，并且想要基于多个表达式属性值生成表达式字符串，请从 ExpressionEditorSheet 类派生自定义表达式编辑器表。 派生类实现应包含以下项：

  • 表达式字符串中每个非重复值的公共属性，可在设计时设置。

  • 方法的实现， GetExpression() 该方法根据编辑器工作表属性值形成自定义表达式字符串。

  • （可选）一个构造函数实现，用于设置编辑器工作表属性的初始值。

关联的自定义表达式编辑器类在 方法中创建 GetExpressionEditorSheet(String, IServiceProvider) 派生编辑器表的实例，使用控件属性的当前表达式字符串来初始化该实例，并将实例返回到可视设计器。 可视化设计器允许您设置表达式表属性，然后调用 GetExpression() 方法以从输入表达式表属性值构成表达式字符串。

构造函数

ExpressionEditorSheet(IServiceProvider)

初始化 ExpressionEditorSheet 类的新实例。

属性

IsValid

获取一个值，该值指示表达式字符串是否有效。
ServiceProvider

获取表达式编辑器表使用的服务提供程序实现。

方法

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetExpression()

当在派生类中重写时，返回由表达式编辑器表属性值组成的表达式字符串。
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type。

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅