EntityDataSource 類別

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.Entity.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示 ASP.NET 應用程式中資料綁定控制的實體資料模型（EDM）。

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

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.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

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

[<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

Public Class EntityDataSource
Inherits DataSourceControl
Implements IDynamicDataSource, IQueryableDataSource

繼承: Object

Control

DataSourceControl
EntityDataSource

屬性: ToolboxBitmapAttribute

實作: IDynamicDataSource IDataSource IQueryableDataSource

備註

本主題內容：

簡介
宣告式語法

簡介

你可以將此 EntityDataSource 控制項與資料綁定控制項結合使用，從 EDM 擷取資料，並在網頁上顯示、編輯及排序資料，幾乎不需程式碼。如需詳細資訊，請參閱 EntityDataSource 網路伺服器控制項概觀。

宣告式語法

<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>

建構函式

名稱	Description
EntityDataSource()	初始化 EntityDataSource 類別的新執行個體。
EntityDataSource(EntityConnection)	初始化一個新的類別實例 EntityDataSource ，並使用所提供的連線。

屬性

名稱	Description
Adapter	拿到瀏覽器專用的控制器轉接器。 (繼承來源 Control)
AppRelativeTemplateSourceDirectory	取得或設定包含此控制項的 or 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	取得 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	在頁面控制階層中，會取得伺服器控制項的父控制權的參考。 (繼承來源 Control)
RenderingCompatibility	會得到一個值，指定渲染後的 HTML 會相容的 ASP.NET 版本。 (繼承來源 Control)
Select	取得或設定投影，定義查詢結果中要包含的屬性。
SelectParameters	取得用來建立投影的參數集合。
Site	當在設計表面渲染時，會取得承載當前控制項的容器資訊。 (繼承來源 Control)
SkinID	讓皮膚貼合對 DataSourceControl 照組。 (繼承來源 DataSourceControl)
StoreOriginalValuesInViewState	取得或設定一個值，指示資料來源的資料是否應該以檢視狀態儲存，以確保資料在更新或刪除前未被其他程序更改。
TemplateControl	取得或設定包含此控制項的範本參考。 (繼承來源 Control)
TemplateSourceDirectory	取得包含當前伺服器控制權的 or Page 虛擬目錄UserControl。 (繼承來源 Control)
UniqueID	取得伺服器控制的唯一、階層限定的識別碼。 (繼承來源 Control)
UpdateParameters	取得更新操作中使用的參數集合。
ValidateRequestMode	取得或設定一個值，指示控制器是否檢查瀏覽器的客戶端輸入是否有潛在危險的值。 (繼承來源 Control)
ViewState	取得狀態資訊字典，讓你能儲存並還原伺服器控制的多個請求，針對同一頁面。 (繼承來源 Control)
ViewStateIgnoresCase	會得到一個值，表示該物件是否 StateBag 不區分大小寫。 (繼承來源 Control)
ViewStateMode	取得或設定此控制的視圖狀態模式。 (繼承來源 Control)
Visible	取得或設定一個值，指示控制項是否以視覺形式顯示。 (繼承來源 DataSourceControl)
Where	取得或設定 Entity SQL 表達式，指定如何篩選查詢結果。
WhereParameters	取得用來建立 WHERE 子句的參數集合。

方法

名稱	Description
AddedControl(Control, Int32)	在將子控制項加入 Controls 物件集合 Control 後被呼叫。 (繼承來源 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, Int32)	搜尋目前的命名容器，使用指定的 `id` 與參數中 `pathOffset` 指定的整數，協助搜尋。你不應該覆蓋這個版本的方法 FindControl 。 (繼承來源 Control)
FindControl(String)	在目前命名容器中搜尋具有指定 `id` 參數的伺服器控制項。 (繼承來源 DataSourceControl)
Focus()	將輸入焦點設定在控制器上。 (繼承來源 DataSourceControl)
GetDesignModeState()	取得設計時數據以支援控制。 (繼承來源 Control)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetRouteUrl(Object)	取得對應一組路由參數的網址。 (繼承來源 Control)
GetRouteUrl(RouteValueDictionary)	取得對應一組路由參數的網址。 (繼承來源 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)	在子控制從物件集合Controls中Control移除後呼叫。 (繼承來源 Control)
Render(HtmlTextWriter)	將伺服器控制內容傳送給所提供的 HtmlTextWriter 物件，該物件會寫入要在用戶端渲染的內容。 (繼承來源 Control)
RenderChildren(HtmlTextWriter)	將伺服器控制子節點的內容輸出到所提供 HtmlTextWriter 物件，該物件會寫入要在用戶端渲染的內容。 (繼承來源 Control)
RenderControl(HtmlTextWriter, ControlAdapter)	伺服器控制內容輸出給所提供的 HtmlTextWriter 物件，使用該物件 ControlAdapter 。 (繼承來源 Control)
RenderControl(HtmlTextWriter)	將伺服器控制內容輸出給所提供 HtmlTextWriter 物件，並在啟用追蹤時儲存關於控制項的追蹤資訊。 (繼承來源 DataSourceControl)
ResolveAdapter()	取得負責渲染指定控制的控制介面卡。 (繼承來源 Control)
ResolveClientUrl(String)	會取得瀏覽器可以使用的網址。 (繼承來源 Control)
ResolveUrl(String)	將一個網址轉換成請求客戶端可用的網址。 (繼承來源 Control)
SaveControlState()	儲存控制項中需要持續保存的屬性 EntityDataSource 狀態。
SaveViewState()	將自頁面發布以來發生的任何伺服器控制權視圖狀態變更，都保存回伺服器。 (繼承來源 Control)
SetDesignModeState(IDictionary)	為控制組設定設計時資料。 (繼承來源 Control)
SetRenderMethodDelegate(RenderMethod)	指派一個事件處理代理，將伺服器控制權及其內容渲染到其父控制中。 (繼承來源 Control)
SetTraceData(Object, Object, Object)	設定追蹤資料，用於設計時追蹤渲染資料，使用追蹤物件、追蹤資料鍵及追蹤資料值。 (繼承來源 Control)
SetTraceData(Object, Object)	使用軌跡資料鍵與痕跡資料值，設定繪圖資料以進行設計時追蹤渲染資料。 (繼承來源 Control)
ToString()	傳回表示目前物件的字串。 (繼承來源 Object)
TrackViewState()	會追蹤伺服器控制項的視圖狀態變更，使其能儲存在伺服器控制項的 StateBag 物件中。此物件可透過屬性 ViewState 存取。
TrackViewState()	會追蹤伺服器控制項的視圖狀態變更，使其能儲存在伺服器控制項的 StateBag 物件中。此物件可透過屬性 ViewState 存取。 (繼承來源 Control)

事件

名稱	Description
ContextCreated	當他們 EntityDataSource 完成建立 ObjectContext 用於處理實體資料物件的時，會發生這種情況。
ContextCreating	當建立 EntityDataSource the ObjectContext that 來處理實體資料物件時，會發生這種情況。
ContextDisposing	發生在處理 ObjectContext 之前。
DataBinding	當伺服器控制項綁定到資料來源時會發生。 (繼承來源 Control)
Deleted	發生在物件從資料來源中被刪除之後。
Deleting	發生在物件從資料來源中刪除之前。
Disposed	當伺服器控制從記憶體中釋放時發生，這是伺服器控制生命週期中請求 ASP.NET 頁面的最後階段。 (繼承來源 Control)
Init	發生在伺服器控制初始化時，這是其生命週期的第一步。 (繼承來源 Control)
Inserted	發生在資料來源建立新物件之後。
Inserting	發生在新物件被持久化到資料來源之前。
Load	當伺服器控制項載入 Page 物件時會發生。 (繼承來源 Control)
PreRender	發生在物件載入後 Control 但渲染之前。 (繼承來源 Control)
QueryCreated	發生在建立 EntityDataSource 一個在控制 EntityDataSource 設定時指定的實體 SQL 查詢之後。
Selected	發生在查詢執行後。
Selecting	發生在查詢建構與執行之前。
Unload	當伺服器控制項從記憶體卸載時發生。 (繼承來源 Control)
Updated	發生在物件變更被持久保存到資料來源後。
Updating	發生在物件變更被持久化到資料來源之前。

明確介面實作

名稱	Description
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)	取得與DataSourceView控制項相關聯的命名DataSourceControl物件。有些資料來源控制項只支援一個視圖，而有些則支援多個視圖。 (繼承來源 DataSourceControl)
IDataSource.GetViewNames()	會獲得一組名稱，代表與DataSourceView控制項相關的物件清單DataSourceControl。 (繼承來源 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()	通知資料綁定控制項參數物件已變更，資料綁定控制項需要重新整理。

擴充方法

名稱	Description
ExpandDynamicWhereParameters(IDynamicDataSource)	將動態濾波器擴展為 `Where` 資料來源可用的參數。
FindDataSourceControl(Control)	回傳與指定控制項相關聯的資料來源。
FindFieldTemplate(Control, String)	回傳指定控制項命名容器中指定欄位的欄位範本。
FindMetaTable(Control)	回傳包含資料控制項的元值物件。
GetDefaultValues(IDataSource)	取得指定資料來源的預設值集合。
GetMetaTable(IDataSource)	取得指定資料來源物件中某個資料表的元資料。
GetTable(IDynamicDataSource)	回傳 MetaTable 與指定資料來源控制相關聯的物件。
TryGetMetaTable(IDataSource, MetaTable)	判斷表格中繼資料是否可用。

適用於

另請參閱

意見反應

此頁面對您有幫助嗎？