System.Data.Entity.Infrastructure 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
類別
| 名稱 | Description |
|---|---|
| CommitFailedException |
當發生錯誤並犯錯 DbTransaction時拋出。 |
| CommitFailureHandler |
一個交易處理器,允許在交易提交過程中優雅地從連線失敗中恢復,透過將交易追蹤資訊儲存在資料庫中。 需要使用 SetDefaultTransactionHandler(Func<TransactionHandler>)。 |
| DbChangeTracker |
透過 ChangeTracker 方法回傳, DbContext 提供與實體變更追蹤相關的上下文功能存取。 |
| DbCollectionEntry |
這是該 DbCollectionEntry<TEntity,TElement> 類別的非通用版本。 |
| DbCollectionEntry<TEntity,TElement> |
此類別的實例會從 的 DbEntityEntry<TEntity> Collection 方法回傳,並允許對實體的集合導航屬性執行載入等操作。 |
| DbCompiledModel |
一個不可變的實體資料模型(EDM)表示,可用於建立或 ObjectContext 可傳遞給 的建構子 DbContext。 為了提升效能,應將此類實例快取並重複使用以構建上下文。 |
| DbComplexPropertyEntry |
這是該 DbComplexPropertyEntry<TEntity,TComplexProperty> 類別的非通用版本。 |
| DbComplexPropertyEntry<TEntity,TComplexProperty> |
此類別的實例會從 的 DbEntityEntry<TEntity> ComplexProperty 方法回傳,並允許存取複雜屬性的狀態。 |
| DbConnectionInfo |
代表資料庫連線的資訊。 |
| DbContextConfiguration |
由設定方法 DbContext 回傳,提供上下文設定選項的存取。 |
| DbContextInfo |
提供關於特定 DbContext 型別的執行時資訊。 |
| DbEntityEntry |
這是該 DbEntityEntry<TEntity> 類別的非通用版本。 |
| DbEntityEntry<TEntity> |
此類別的實例提供關於被追蹤 DbContext實體的資訊與控制權。 使用上下文中的 Entity 或 Entities 方法來取得此類物件。 |
| DbExecutionStrategy |
提供針對不可靠操作及暫態狀況的重試機制基礎實作,利用重試間指數級增加的延遲。 |
| DbMemberEntry |
這是一種抽象基底類別,用來表示純量或複雜屬性,或是實體的導航屬性。 純量與複雜屬性使用導出類別 DbPropertyEntry,參考導航屬性使用導出類別 DbReferenceEntry,集合導航屬性使用導出類別 DbCollectionEntry。 |
| DbMemberEntry<TEntity,TProperty> |
這是一種抽象基底類別,用來表示純量或複雜屬性,或是實體的導航屬性。 純量與複雜屬性使用導出類別 DbPropertyEntry<TEntity,TProperty>,參考導航屬性使用導出類別 DbReferenceEntry<TEntity,TProperty>,集合導航屬性使用導出類別 DbCollectionEntry<TEntity,TElement>。 |
| DbModel |
代表由 DbModelBuilder建立的實體資料模型(EDM)。 編譯方法可從此 EDM 表示法轉換成 DbCompiledModel 適合快取及建立 DbContext 實 ObjectContext 例的編譯快照。 |
| DbModelStore |
持久化模型快取的基底類別。 |
| DbPropertyEntry |
這是該 DbPropertyEntry<TEntity,TProperty> 類別的非通用版本。 |
| DbPropertyEntry<TEntity,TProperty> |
此類別的實例可從 的 DbEntityEntry<TEntity> Property 方法回傳,並允許存取標量或複數屬性的狀態。 |
| DbPropertyValues |
一個底層實體或複雜物件所有屬性的集合。 |
| DbProviderInfo |
將一對識別提供者與伺服器版本的字串合併為單一物件。 |
| DbQuery |
代表非通用的 LINQ 對 Entities 的查詢,針對 DbContext。 |
| DbQuery<TResult> |
代表對資料庫上下文的 LINQ 對實體的查詢。 |
| DbRawSqlQuery |
代表一個非實體的 SQL 查詢,該查詢由 建立 DbContext ,並利用該上下文的連線執行。 此類別的實例由實 Database 例取得。 當建立此物件時,查詢並未被執行;每次列舉時都會執行,例如使用 foreach。 實體的 SQL 查詢是使用 SqlQuery(String, Object[])。 請參閱 DbRawSqlQuery<TElement> 此類別的通用版本。 |
| DbRawSqlQuery<TElement> |
代表一個非實體的 SQL 查詢,該查詢由 建立 DbContext ,並利用該上下文的連線執行。
此類別的實例由實 Database 例取得。
當建立此物件時,查詢並未被執行;每次列舉時都會執行,例如使用 |
| DbReferenceEntry |
這是該 DbReferenceEntry<TEntity,TProperty> 類別的非通用版本。 |
| DbReferenceEntry<TEntity,TProperty> |
此類別的實例會從 的 DbEntityEntry<TEntity> Reference 方法回傳,並允許對實體的參考導航屬性執行載入等操作。 |
| DbSqlQuery |
代表一個由 建立 DbContext 並利用該上下文連線執行的實體 SQL 查詢。 此類別的實例來自 DbSet 實體類型的實例。 當建立此物件時,查詢並未被執行;每次列舉時都會執行,例如使用 foreach。 非實體的 SQL 查詢則使用 SqlQuery(Type, String, Object[])。 請參閱 DbSqlQuery<TEntity> 此類別的通用版本。 |
| DbSqlQuery<TEntity> |
代表一個由 建立 DbContext 並利用該上下文連線執行的實體 SQL 查詢。 此類別的實例來自 DbSet<TEntity> 實體類型的實例。 當建立此物件時,查詢並未被執行;每次列舉時都會執行,例如使用 foreach。 非實體的 SQL 查詢則使用 SqlQuery<TElement>(String, Object[])。 請參閱 DbSqlQuery 此類別的非通用版本。 |
| DbUpdateConcurrencyException |
當預期某實體的 SaveChanges 會導致資料庫更新,但實際上資料庫中沒有任何列受到影響時,卻拋 DbContext 出了例外。 這通常表示資料庫已被同時更新,導致原本預期會匹配的並行標記實際上並未匹配。 請注意,此例外所參考的狀態項目因安全性考量不會被序列化,序列化後對狀態項目的存取將回傳為空。 |
| DbUpdateException |
當資料庫變更儲存失敗時會 DbContext 拋出例外。 請注意,此例外所參考的狀態項目因安全性考量不會被序列化,序列化後對狀態項目的存取將回傳為空。 |
| DefaultDbModelStore |
在指定位置將模型載入或儲存到 .edmx 檔案。 |
| DefaultExecutionStrategy |
而且 IDbExecutionStrategy 如果操作失敗,也不會重試。 |
| DefaultManifestTokenResolver |
預設實作 IManifestTokenResolver 會使用底層提供者來取得 manifest token。 請注意,為避免多次查詢,此實作會根據實例的實際類型 DbConnection 、 DataSource 屬性和 Database 屬性進行快取。 |
| EdmMetadata |
代表用於在資料庫中儲存有關 EDM 的元資料的實體。 |
| EdmxReader |
用來從 .edmx 讀取元資料模型的工具類別。 |
| EdmxWriter |
包含用於存取由 Code First 以 EDMX 形式建立的實體資料模型的方法。 這些方法通常用於除錯,當需要檢視 Code First 內部建立的模型時。 |
| ExecutionStrategyKey |
一個用於解析 Func<TResult>的鍵。 它由 ADO.NET 提供者不變名稱以及資料庫伺服器名稱(依照 連接字串 所指定)組成。 |
| IncludeMetadataConvention |
此 DbModelBuilder 慣例使 DbModelBuilder 在建置模型時包含關於模型的元資料。 當 DbContext 依慣例建立模型時,會將此慣例加入 DbModelBuilder 使用的慣例清單中。 若使用 DbContext 建立資料庫,模型中繼資料就會寫入資料庫。 這可作為快速檢查,看看模型自上次使用以來是否改變。 此慣例可透過覆寫衍生 DbContext 類別上的 OnModelCreating 方法來移除 DbModelBuilder 。 |
| LocalDbConnectionFactory |
此類別的實例用於根據給定的資料庫名稱或 連接字串 建立 SQL Server LocalDb 的 DbConnection 物件。 |
| ModelContainerConvention |
此 DbModelBuilder 慣例使用衍生 DbContext 類別的名稱作為 Code First 所建構概念模型的容器。 |
| ModelNamespaceConvention |
此 DbModelBuilder 慣例使用派生 DbContext 類別的命名空間作為 Code First 所建構概念模型的命名空間。 |
| ObjectReferenceEqualityComparer |
利用參考等式比較物件。 |
| ReplacementDbQueryWrapper<TElement> |
此類別的實例在內部用於建立常數表達 ObjectQuery<T> 式,並將其插入表達式樹中以替換對 DbQuery<TResult> 和 DbQuery的引用。 |
| RetryLimitExceededException |
當動作重複設定次數後再次失敗時,會拋出的例外。 |
| SqlCeConnectionFactory |
此類別的實例用於根據給定資料庫名稱或 連接字串 建立 SQL Server Compact Edition 的 DbConnection 物件。 |
| SqlConnectionFactory |
此類別的實例用於根據給定資料庫名稱或 連接字串 建立 SQL Server 的 DbConnection 物件。 預設連線是連接到 '.\SQLEXPRESS'。 這可以透過在建構工廠實例時更改基礎 連接字串 來改變。 |
| SuppressDbSetInitializationAttribute |
此屬性可套用於整個衍生 DbContext 類別,或套用於該類別上的個別 DbSet<TEntity> 或 IDbSet<TEntity> 屬性。 應用後,發現的或DbSet<TEntity>IDbSet<TEntity>屬性仍會包含在模型中,但不會自動初始化。 |
| TableExistenceChecker |
由 Entity Framework 提供者實作,用來檢查特定資料庫中是否存在資料表。 資料庫初始化器會用此方法判斷是否應將現有資料庫視為空,以便建立資料表。 |
| TransactionContext |
此類別用於 CommitFailureHandler 從資料庫中寫入及讀取交易追蹤資訊。 若要自訂交易表的定義,你可以從此類別推導並覆寫 OnModelCreating(DbModelBuilder)。 導出類別可用 註冊。DbConfiguration |
| TransactionHandler |
這是處理交易操作的攔截器的基底類別。 導出類別可用 或 SetTransactionHandler(String, Func<TransactionHandler>, String)來註冊SetDefaultTransactionHandler(Func<TransactionHandler>)。 |
| TransactionRow |
R代表一筆交易 |
| UnintentionalCodeFirstException |
當從範本以資料庫優先或模型優先模式產生 DbContext 上下文,然後在程式碼優先模式下使用時,會拋出該訊息。 |
介面
| 名稱 | Description |
|---|---|
| IDbAsyncEnumerable |
介面的 IEnumerable 非同步版本,允許非同步擷取元素。 此介面用於與 Entity Framework 查詢互動,不應由自訂類別實作。 |
| IDbAsyncEnumerable<T> |
介面的 IEnumerable<T> 非同步版本,允許非同步檢索可枚舉序列的元素。 此介面用於與 Entity Framework 查詢互動,不應由自訂類別實作。 |
| IDbAsyncEnumerator |
介面的 IEnumerator 非同步版本,允許非同步擷取元素。 此介面用於與 Entity Framework 查詢互動,不應由自訂類別實作。 |
| IDbAsyncEnumerator<T> |
介面的 IEnumerator<T> 非同步版本,允許非同步擷取元素。 此介面用於與 Entity Framework 查詢互動,不應由自訂類別實作。 |
| IDbAsyncQueryProvider |
定義了建立並非同步執行由物件描述 IQueryable 的查詢的方法。 此介面用於與 Entity Framework 查詢互動,不應由自訂類別實作。 |
| IDbConnectionFactory |
此介面的實作用於根據特定資料庫名稱建立一種資料庫伺服器的 DbConnection 物件。 在類別上設置Database一個實例,使所有建立的 DbContext 預設使用某種類型的資料庫伺服器,這些 DbContext 沒有連接資訊或僅有資料庫名稱或 連接字串。 此介面提供兩種實作:SqlConnectionFactory用於建立與 Microsoft SQL Server 的連線,包括 EXPRESS 版本。 SqlCeConnectionFactory用於建立與 Microsoft SQL Server Compact Editions 的連線。 其他資料庫伺服器的實作可視需要加入。 請注意,實作應是執行緒安全或不可變的,因為可能同時被多個執行緒存取。 |
| IDbContextFactory<TContext> |
一個用來建立衍生 DbContext 實例的工廠。 實作此介面以啟用設計時服務,適用於沒有公開預設建構器的上下文類型。 在設計時,可以建立衍生 DbContext 實例,以啟用特定的設計時體驗,例如模型渲染、DDL 產生等。為了讓沒有公開預設建構子的衍生 DbContext 型態能夠實現設計時實例化,請實作此介面。 設計時服務會自動發現與衍生 DbContext 型別同一組件中的此介面實作。 |
| IDbExecutionStrategy |
一種用於對資料庫執行指令或查詢的策略,可能還會包含在失敗發生時重試的邏輯。 |
| IDbModelCacheKey |
代表一個關鍵值,唯一識別已載入記憶體的實體框架模型。 |
| IDbModelCacheKeyProvider |
在你的上下文中實作這個介面,利用自訂邏輯計算用來查找快取中已建立模型的鍵數。 這個介面允許你擁有單一情境類型,可以同時用於同一 AppDomain 中的不同模型,或是多個使用相同模型的情境類型。 |
| IDbProviderFactoryResolver |
一項用於從特定 DbConnection.DbProviderFactory |
| IManifestTokenResolver |
一個讓提供者清單代幣獲得連線的服務。 DefaultManifestTokenResolver該類別預設使用,並利用底層提供者取得憑證,通常涉及開啟連線。 另一種實作則是加入 , IDbDependencyResolver 該 to DbConfiguration 可利用連線中的任何資訊回傳標記。 例如,若連線已知指向 SQL Server 2008 資料庫,則可在不開啟連線的情況下回傳「2008」。 |
| IMetadataAnnotationSerializer |
實作此介面,允許以實例代表 MetadataProperty 的自訂註解序列化至EDMX XML與XML之間。 通常會使用此 SetMetadataAnnotationSerializer(String, Func<IMetadataAnnotationSerializer>) 方法設定序列化器實例。 |
| IObjectContextAdapter |
由能提供 ObjectContext 實例的物件實作的介面。 該 DbContext 類別實作此介面以提供對底層 ObjectContext 的存取。 |
| IProviderInvariantName |
在解析提供者不變名稱時DbProviderFactory,會被 和 使用 。IDbDependencyResolverDbConfiguration |
列舉
| 名稱 | Description |
|---|---|
| DbConnectionStringOrigin |
描述與 DbContext相關聯的資料庫 連接字串 的來源。 |