属性页(EntityDataSource 控件)
更新:2007 年 11 月
当设计时控件在网页设计图面上处于选定状态时,ASP.NET EntityDataSource 控件的**“属性页”会显示在 Visual Studio IDE 中。“属性页”**提供了设置各个值的功能,即便根据元数据的特定视图这些值看上去不正确也是如此。
说明: |
---|
与“配置数据源”向导中显示的数据不同,在“属性页”上选择一个与其他属性相关的属性不会自动更新该相关属性以反映有效值。在“配置数据源”向导中,如果在“DefaultContainerName”下拉列表中选择 EntityContainer,则该容器的有效实体集会自动填充“EntitySetName”下拉列表中可用实体集的列表,并且“EntitySetName”的所有先前值都会被清除。该向导为配置提供限制性的视图。 |
尽管依赖属性的属性值不会按**“属性页”自动对齐,但指定属性的下拉列表中的可能值可能基于其他值。例如,如果识别出当前 ContainerName,则展开“EntitySetName”**的下拉列表会显示该 ContainerName 的有效实体集的列表。
下图演示了带属性赋值的**“属性页”**。
下面的列表介绍 EntityDataSource 控件的属性行为。
行为组中的所有属性均为布尔型,并且在下拉列表中仅允许 True 或 False。
ConnectionString 是一个简单字符串。该字符串的有效性在运行时确定。
DefaultContainerName 是与本主题前面针对向导所述的相同实体容器集的下拉列表。用户还可以输入列表中不存在的容器名称。在运行时会检测出无效的名称。
EntitySetName 是所选容器名称的实体集的下拉列表。如果在可检测到的元数据中未找到容器名称,则此属性可能为空。用户可以输入列表中不存在的 EntitySetName。在运行时会检测出无效的名称。
GroupBy 是一个没有参数的简单字符串。
OrderBy、Where、Select 和 CommandText 由两部分组成:
一个包含表达式文本的字符串。
这些表达式中使用的参数。**“属性页”**仅显示该字符串。参数是不可见的,除非您再次单击生成器省略号或直接查看标记。有关这些属性的生成器对话框的更多信息,请参见表达式编辑器(实体数据源控件)中的 OrderBy、Select、Where 以及 CommandText 对话框。
EntityTypeFilter 是在**“配置数据源”**向导中显示的相同类型集的下拉列表,前提是 EntitySetName 属性不为空且已在元数据中识别。用户可以输入列表中不存在的值。在运行时会检测出无效的名称。
ID 是页面标记中控件的标识符。
事件页
**“事件”**页显示 EntityDataSource 控件的公共事件。Visual Studio 提供一个下拉列表,显示用于为此事件的处理程序匹配合适签名的所有方法。用户可以双击属性值以添加新方法,或跳到现有方法(如果代码中已经存在)。
下图演示了 EntityDataSource 控件事件页。