EntityDataSource 类

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.Entity.dll

表示 ASP.NET 应用程序中数据绑定控件的实体数据模型 (EDM)。

public ref class EntityDataSource : System::Web::UI::DataSourceControl, System::Web::DynamicData::IDynamicDataSource, System::Web::UI::WebControls::IQueryableDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.EntityDataSource), "EntityDataSource.ico")]
public class EntityDataSource : System.Web.UI.DataSourceControl, System.Web.DynamicData.IDynamicDataSource, System.Web.UI.WebControls.IQueryableDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.EntityDataSource), "EntityDataSource.ico")>]
type EntityDataSource = class
    inherit DataSourceControl
    interface IDynamicDataSource
    interface IDataSource
    interface IQueryableDataSource

Public Class EntityDataSource
Inherits DataSourceControl
Implements IDynamicDataSource, IQueryableDataSource

继承

Object

Control

DataSourceControl

EntityDataSource

属性

ToolboxBitmapAttribute

实现

IDynamicDataSource IDataSource IQueryableDataSource

注解

本主题内容：

• 介绍

• 声明性语法

介绍

可以将控件 EntityDataSource 与数据绑定控件一起使用，以便从 EDM 检索数据，并通过很少或不使用代码在网页上显示、编辑和排序数据。 有关详细信息，请参阅 EntityDataSource Web 服务器控件概述。

声明性语法

<asp:EntityDataSource
    AutoGenerateOrderByClause="True|False"
    AutoGenerateWhereClause="True|False"
    AutoPage="True|False"
    AutoSort="True|False"
    CommandText="string"
    ConnectionString="string"
    ContextType="typed ObjectContext"
    ContextTypeName="string"
    DefaultContainerName="string"
    EnableDelete="True|False"
    EnableInsert="True|False"
    EnableUpdate="True|False"
    EnableViewState="True|False"
    EntitySetName="string"
    EntityTypeFilter="string"
    GroupBy="string"
    Include="string"
    OnContextCreated="ContextCreated event handler"
    OnContextCreating="ContextCreating event handler"
    OnContextDisposing="ContextDisposing event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnException="IDynamicDataSource.Exception event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    OrderBy="string"
    runat="server"
    Select="string"
    StoreOriginalValuesInViewState="True|False"
    Where="string"
>
        <CommandParameters />
        <DeleteParameters />
        <GroupByParameters />
        <InsertParameters />
        <OrderByParameters />
        <SelectParameters />
        <UpdateParameters />
        <WhereParameters />
</asp:EntityDataSource>

构造函数

EntityDataSource()	初始化 EntityDataSource 类的新实例。
EntityDataSource(EntityConnection)	使用提供的连接初始化 EntityDataSource 类的新实例。

属性

Adapter	获取控件的浏览器特定适配器。 (继承自 Control)
AppRelativeTemplateSourceDirectory	获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control)
AutoGenerateOrderByClause	获取或设置一个值，该值指示 EntityDataSource 控件是否根据 OrderByParameters 集合中的值动态创建 ORDER BY 子句。
AutoGenerateWhereClause	获取或设置一个值，该值指示 EntityDataSource 控件是否基于 WhereParameters 集合中定义的值来动态创建 WHERE 子句。
AutoPage	获取或设置一个值，该值指示 EntityDataSource 控件是否支持在运行时在数据的各部分之间导航。
AutoSort	获取或设置一个值，该值指示 EntityDataSource 控件是否支持在运行时对数据进行排序。
BindingContainer	获取包含该控件的数据绑定的控件。 (继承自 Control)
ChildControlsCreated	获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control)
ClientID	获取由 ASP.NET 生成的服务器控件标识符。 (继承自 DataSourceControl)
ClientIDMode	此属性不用于数据源控件。 (继承自 DataSourceControl)
ClientIDSeparator	获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control)
CommandParameters	获取查询的参数集合。
CommandText	获取或设置定义查询的 Entity SQL 命令。
ConnectionString	获取或设置用于执行查询的连接字符串。
Context	为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control)
ContextType	获取或设置 ObjectContext 控件使用的类型化 EntityDataSource。
ContextTypeName	获取或设置 ObjectContext 控件使用的类型化 EntityDataSource 的完全限定名。
Controls	获取 ControlCollection 对象，该对象表示 UI 层次结构中的指定服务器控件的子控件。 (继承自 DataSourceControl)
DataItemContainer	如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control)
DataKeysContainer	如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control)
DefaultContainerName	获取或设置默认容器名称。
DeleteParameters	获取在删除操作过程中使用的参数的集合。
DesignMode	获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control)
EnableDelete	获取或设置一个值，该值指示是否可以通过 EntityDataSource 控件删除对象。
EnableFlattening	获取或设置一个值，该值指示是否关闭包装创建。
EnableInsert	获取或设置一个值，该值指示是否可以通过 EntityDataSource 控件添加对象。
EnableTheming	获取一个值，该值指示此控件是否支持主题。 (继承自 DataSourceControl)
EnableUpdate	获取或设置一个值，该值指示是否可以通过 EntityDataSource 控件修改对象。
EnableViewState	获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control)
EntitySetName	获取或设置 EntityDataSource 控件使用的实体集的名称。
EntityTypeFilter	获取或设置将查询结果限定为特定派生类型的表达式。
Events	获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control)
GroupBy	获取或设置指定如何对查询结果分组的 Entity SQL 表达式。
HasChildViewState	获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control)
ID	获取或设置分配给服务器控件的编程标识符。 (继承自 Control)
IdSeparator	获取用于分隔控件标识符的字符。 (继承自 Control)
Include	获取或设置指定要包含在查询结果中的相关对象的表达式。
InsertParameters	获取在插入操作过程中使用的参数的集合。
IsChildControlStateCleared	获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control)
IsTrackingViewState	获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control)
IsViewStateEnabled	获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control)
LoadViewStateByID	获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control)
NamingContainer	获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control)
OrderBy	获取或设置指定如何对查询结果进行排序的 Entity SQL 表达式。
OrderByParameters	获取用于创建 ORDER BY 子句的参数的集合。
Page	获取对包含服务器控件的 Page 实例的引用。 (继承自 Control)
Parent	获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control)
RenderingCompatibility	获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control)
Select	获取或设置投影，该投影定义要包括在查询结果中的属性。
SelectParameters	获取用于创建投影的参数的集合。
Site	获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control)
SkinID	获取要应用于 DataSourceControl 控件的外观。 (继承自 DataSourceControl)
StoreOriginalValuesInViewState	获取或设置一个值，该值指示数据源中的数据是否存储在视图状态中，以确保数据在更新或删除之前不会由其他进程更改。
TemplateControl	获取或设置对包含该控件的模板的引用。 (继承自 Control)
TemplateSourceDirectory	获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control)
UniqueID	获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control)
UpdateParameters	获取在更新操作过程中使用的参数的集合。
ValidateRequestMode	获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control)
ViewState	获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control)
ViewStateIgnoresCase	获取一个值，该值指示 StateBag 对象是否不区分大小写。 (继承自 Control)
ViewStateMode	获取或设置此控件的视图状态模式。 (继承自 Control)
Visible	获取或设置一个值，该值指示是否以可视化方式显示控件。 (继承自 DataSourceControl)
Where	获取或设置指定如何筛选查询结果的 Entity SQL 表达式。
WhereParameters	获取用于创建 WHERE 子句的参数的集合。

方法

AddedControl(Control, Int32)	在子控件添加到 Control 对象的 Controls 集合后调用。 (继承自 Control)
AddParsedSubObject(Object)	通知服务器控件，分析了一个元素（XML 或 HTML），并将该元素添加到服务器控件的 ControlCollection 对象中。 (继承自 Control)
ApplyStyleSheetSkin(Page)	将页样式表中定义的样式属性应用于控件。 (继承自 DataSourceControl)
BeginRenderTracing(TextWriter, Object)	开始输出数据的设计时追踪。 (继承自 Control)
BuildProfileTree(String, Boolean)	收集有关服务器控件的信息并将该信息发送到 Trace 属性，在启用页的跟踪功能时将显示该属性。 (继承自 Control)
ClearCachedClientID()	将缓存的 ClientID 值设置为 null。 (继承自 Control)
ClearChildControlState()	删除服务器控件的子控件的控件状态信息。 (继承自 Control)
ClearChildState()	删除服务器控件的所有子控件的视图状态和控件状态信息。 (继承自 Control)
ClearChildViewState()	删除服务器控件的所有子控件的视图状态信息。 (继承自 Control)
ClearEffectiveClientIDMode()	将当前控件实例和任何子控件的 ClientIDMode 属性设置为 Inherit。 (继承自 Control)
CreateChildControls()	由 ASP.NET 页框架调用，以通知服务器控件在准备回发或呈现时使用基于撰写的实现来创建其所包含任何子控件。 (继承自 Control)
CreateControlCollection()	创建用于存储子控件的集合。 (继承自 DataSourceControl)
CreateView()	创建与此控件相关联的 EntityDataSourceView 的新实例。
DataBind()	将数据源绑定到调用的服务器控件及其所有子控件。 (继承自 Control)
DataBind(Boolean)	将数据源绑定到调用的服务器控件及其所有子控件，同时可以选择引发 DataBinding 事件。 (继承自 Control)
DataBindChildren()	将数据源绑定到服务器控件的子控件。 (继承自 Control)
Dispose()	使服务器控件得以在从内存中释放之前执行最后的清理操作。 (继承自 Control)
EndRenderTracing(TextWriter, Object)	结束输出数据的设计时追踪。 (继承自 Control)
EnsureChildControls()	确定服务器控件是否包含子控件。 如果不包含，则创建子控件。 (继承自 Control)
EnsureID()	为尚未分配标识符的控件创建标识符。 (继承自 Control)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
FindControl(String)	在当前的命名容器中搜索带指定 id 参数的服务器控件。 (继承自 DataSourceControl)
FindControl(String, Int32)	使用指定的 id 和 pathOffset 参数（该参数有助于搜索）中指定的整数在当前命名容器中搜索服务器控件。 不应重写此版本的 FindControl 方法。 (继承自 Control)
Focus()	为控件设置输入焦点。 (继承自 DataSourceControl)
GetDesignModeState()	获取控件的设计时数据。 (继承自 Control)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetRouteUrl(Object)	获取与一组路由参数对应的 URL。 (继承自 Control)
GetRouteUrl(RouteValueDictionary)	获取与一组路由参数对应的 URL。 (继承自 Control)
GetRouteUrl(String, Object)	获取与一组路由参数以及某个路由名称对应的 URL。 (继承自 Control)
GetRouteUrl(String, RouteValueDictionary)	获取与一组路由参数以及某个路由名称对应的 URL。 (继承自 Control)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetUniqueIDRelativeTo(Control)	返回指定控件的 UniqueID 属性的前缀部分。 (继承自 Control)
GetView(String)	获取与数据源控件关联的命名的数据源视图。
GetViewNames()	获取名称的集合，这些名称表示与 EntityDataSource 控件关联的视图对象的列表。
HasControls()	确定服务器控件是否包含任何子控件。 (继承自 DataSourceControl)
HasEvents()	返回一个值，该值指示是否为控件或任何子控件注册事件。 (继承自 Control)
IsLiteralContent()	确定服务器控件是否只包含文字内容。 (继承自 Control)
LoadControlState(Object)	加载 EntityDataSource 控件中需要保留的属性的状态。
LoadViewState(Object)	从用 SaveViewState() 方法保存的上一个页面请求还原视图状态信息。 (继承自 Control)
MapPathSecure(String)	检索虚拟路径（绝对的或相对的）映射到的物理路径。 (继承自 Control)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnBubbleEvent(Object, EventArgs)	确定服务器控件的事件是否沿页的 UI 服务器控件层次结构向上传递。 (继承自 Control)
OnDataBinding(EventArgs)	引发 DataBinding 事件。 (继承自 Control)
OnInit(EventArgs)	将 LoadComplete 事件处理程序添加到包含 Page 控件的 EntityDataSource 控件中。
OnLoad(EventArgs)	引发 Load 事件。 (继承自 Control)
OnPreRender(EventArgs)	引发 PreRender 事件。 (继承自 Control)
OnUnload(EventArgs)	引发 Unload 事件。
OpenFile(String)	获取用于读取文件的 Stream。 (继承自 Control)
RaiseBubbleEvent(Object, EventArgs)	将所有事件源及其信息分配给控件的父级。 (继承自 Control)
RaiseDataSourceChangedEvent(EventArgs)	引发 DataSourceChanged 事件。 (继承自 DataSourceControl)
RemovedControl(Control)	从 Control 对象的 Controls 集合移除子控件后调用。 (继承自 Control)
Render(HtmlTextWriter)	将服务器控件内容发送到给定的 HtmlTextWriter 对象，该对象可编写将在客户端呈现的内容。 (继承自 Control)
RenderChildren(HtmlTextWriter)	将服务器控件子级的内容输出到提供的 HtmlTextWriter 对象，该对象可写入要在客户端上呈现的内容。 (继承自 Control)
RenderControl(HtmlTextWriter)	将服务器控件内容输出到所提供的 HtmlTextWriter 对象，如果启用了跟踪，则还将存储有关该控件的跟踪信息。 (继承自 DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)	使用提供的 HtmlTextWriter 对象将服务器控件内容输出到提供的 ControlAdapter 对象。 (继承自 Control)
ResolveAdapter()	获取负责呈现指定控件的控件适配器。 (继承自 Control)
ResolveClientUrl(String)	获取浏览器可以使用的 URL。 (继承自 Control)
ResolveUrl(String)	将 URL 转换为在请求客户端可用的 URL。 (继承自 Control)
SaveControlState()	保存 EntityDataSource 控件中需要保留的属性的状态。
SaveViewState()	保存将页面回发到服务器之后发生的所有服务器控件视图状态更改。 (继承自 Control)
SetDesignModeState(IDictionary)	为控件设置设计时数据。 (继承自 Control)
SetRenderMethodDelegate(RenderMethod)	分配事件处理程序委托，以将服务器控件及其内容呈现到父控件中。 (继承自 Control)
SetTraceData(Object, Object)	使用跟踪数据键和跟踪数据值，为呈现数据的设计时追踪设置跟踪数据。 (继承自 Control)
SetTraceData(Object, Object, Object)	使用跟踪对象、跟踪数据键和跟踪数据值，为呈现数据的设计时追踪设置跟踪数据。 (继承自 Control)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TrackViewState()	导致跟踪服务器控件的视图状态的更改，以便这些更改可以存储到服务器控件的 StateBag 对象中。 通过 ViewState 属性可访问此对象。

事件

ContextCreated	在 EntityDataSource 创建完用于处理实体数据对象的 ObjectContext 之后发生。
ContextCreating	当 EntityDataSource 创建用于处理实体数据对象的 ObjectContext 时发生。
ContextDisposing	在释放 ObjectContext 之前发生。
DataBinding	当服务器控件绑定到数据源时发生。 (继承自 Control)
Deleted	在从数据源中删除对象之后发生。
Deleting	在从数据源中删除对象之前发生。
Disposed	当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control)
Init	当服务器控件初始化时发生；初始化是控件生存期的第一步。 (继承自 Control)
Inserted	在数据源中创建新对象之后发生。
Inserting	在将新对象保留到数据源之前发生。
Load	当服务器控件加载到 Page 对象中时发生。 (继承自 Control)
PreRender	在加载 Control 对象之后、呈现之前发生。 (继承自 Control)
QueryCreated	出现在 EntityDataSource 创建配置 EntityDataSource 控件过程中指定的 Entity SQL 之后。
Selected	在执行查询之后发生。
Selecting	在构建并执行查询之前发生。
Unload	当服务器控件从内存中卸载时发生。 (继承自 Control)
Updated	在将对象更改保留到数据源之后发生。
Updating	在将对象更改保留到数据源之前发生。

显式接口实现

IControlBuilderAccessor.ControlBuilder	有关此成员的说明，请参见 ControlBuilder。 (继承自 Control)
IControlDesignerAccessor.GetDesignModeState()	有关此成员的说明，请参见 GetDesignModeState()。 (继承自 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	有关此成员的说明，请参见 SetDesignModeState(IDictionary)。 (继承自 Control)
IControlDesignerAccessor.SetOwnerControl(Control)	有关此成员的说明，请参见 SetOwnerControl(Control)。 (继承自 Control)
IControlDesignerAccessor.UserData	有关此成员的说明，请参见 UserData。 (继承自 Control)
IDataBindingsAccessor.DataBindings	有关此成员的说明，请参见 DataBindings。 (继承自 Control)
IDataBindingsAccessor.HasDataBindings	有关此成员的说明，请参见 HasDataBindings。 (继承自 Control)
IDataSource.DataSourceChanged	当数据源控件以某种影响数据绑定控件的方式发生更改时发生。 (继承自 DataSourceControl)
IDataSource.GetView(String)	获取与 DataSourceControl 控件关联的指定 DataSourceView 对象。 有些数据源控件只支持一个视图，有些则支持多个视图。 (继承自 DataSourceControl)
IDataSource.GetViewNames()	获取名称的集合，表示与 DataSourceControl 控件关联的 DataSourceView 对象的列表。 (继承自 DataSourceControl)
IDynamicDataSource.Exception	在分部方法中验证失败或引发异常时发生。
IExpressionsAccessor.Expressions	有关此成员的说明，请参见 Expressions。 (继承自 Control)
IExpressionsAccessor.HasExpressions	有关此成员的说明，请参见 HasExpressions。 (继承自 Control)
IListSource.ContainsListCollection	指示数据源控件是否与一个或多个数据列表相关联。 (继承自 DataSourceControl)
IListSource.GetList()	获取可用作数据列表的源的数据源控件列表。 (继承自 DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	有关此成员的说明，请参见 AddParsedSubObject(Object)。 (继承自 Control)
IQueryableDataSource.RaiseViewChanged()	通知数据绑定控件，告知其参数对象已更改，并且数据绑定控件需要刷新。

扩展方法

ExpandDynamicWhereParameters(IDynamicDataSource)	将动态筛选器扩展到可供数据源使用的 Where 参数中。
FindDataSourceControl(Control)	返回与指定控件的数据控件关联的数据源。
FindFieldTemplate(Control, String)	返回指定控件的命名容器中指定列的字段模板。
FindMetaTable(Control)	返回包含数据控件的元表对象。
GetDefaultValues(IDataSource)	为指定数据源获取默认值的集合。
GetMetaTable(IDataSource)	获取指定数据源对象中表的元数据。
GetTable(IDynamicDataSource)	返回与指定数据源控件关联的 MetaTable 对象。
TryGetMetaTable(IDataSource, MetaTable)	确定表元数据是否可用。

另请参阅

• 实体框架概述
• 使用对象