class="title">EntityConnectionStringBuilder 類別

.NET Framework 4 其他版本 本主題尚未接受評分 - 為這個主題評分

1999/xhtml">提供簡單的方式來建立和管理 EntityClient 所使用的連接字串內容。

繼承階層架構

---

命名空間：  System.Data.EntityClient
組件：  System.Data.Entity (在 System.Data.Entity.dll 中) 語法

---

C# C++ F# VB

monospace; word-wrap: normal; overflow: auto; font-weight: normal; padding-top: 5px">public sealed class EntityConnectionStringBuilder : DbConnectionStringBuilder

EntityConnectionStringBuilder 型別會公開下列成員。

建構函式

---

  名稱 說明 EntityConnectionStringBuilder() instance of the <span><span class="selflink">EntityConnectionStringBuilder</span></span> class." data-guid="befa526be92ef992436d4534d4d81ac1">EntityConnectionStringBuilder class.' data-guid="befa526be92ef992436d4534d4d81ac1">初始化 EntityConnectionStringBuilder 類別的新執行個體。 EntityConnectionStringBuilder(String) EntityConnectionStringBuilder class using the supplied connection string. ' data-guid="f437c2f75c0d4744daecf2dc9f9ce709">使用所提供的連接字串，初始化 EntityConnectionStringBuilder 類別的新執行個體。 回頁首 屬性

---

  名稱 說明 BrowsableConnectionString Studio designers." data-guid="00794c09e2cd2b948a6ba44324c8cf1a">ConnectionString property is visible in Visual Studio designers.' data-guid="00794c09e2cd2b948a6ba44324c8cf1a">取得或設定值，指出 ConnectionString 屬性在 Visual Studio 設計工具中是否為可見的。 (繼承自DbConnectionStringBuilder)。 ConnectionString DbConnectionStringBuilder.' data-guid="7521d216e086a343fda32a828780d187">取得或設定與 DbConnectionStringBuilder 關聯的連接字串。 (繼承自 DbConnectionStringBuilder)。 Count ConnectionString property.' data-guid="a6afc65642950e1cc581d6447e2b9387">取得目前包含在 ConnectionString 屬性之內的索引鍵數目。 (繼承自 DbConnectionStringBuilder)。 IsFixedSize has a fixed size." data-guid="da40f50ca626760ae8da33bdf8db71e7">EntityConnectionStringBuilder has a fixed size.' data-guid="da40f50ca626760ae8da33bdf8db71e7">取得值，指出 EntityConnectionStringBuilder 是否有固定的大小。 (覆寫DbConnectionStringBuilder.IsFixedSize。) IsReadOnly DbConnectionStringBuilder is read-only.' data-guid="3f66aacd502c1724c28ab549ae431935">取得值，指出 DbConnectionStringBuilder 是否為唯讀。 (繼承自 DbConnectionStringBuilder)。 Item 取得或設定和指定索引鍵關聯的值。 在 C# 中，這個屬性是索引子。 (覆寫DbConnectionStringBuilder.Item[String]。) Keys ICollection that contains the keys in the EntityConnectionStringBuilder.' data-guid="1fe5ab1dc259b0267fc0d89c4f4ed895">取得 EntityConnectionStringBuilder 中包含索引鍵的 ICollection。 (覆寫 DbConnectionStringBuilder.Keys。) Metadata 取得或設定連接字串內的中繼資料位置。 Name 取得或設定組態檔中所定義的區段名稱。 Provider 取得或設定連接字串中的基礎 .NET Framework 資料提供者名稱。 ProviderConnectionString 取得或設定提供者專用的內部連接字串。 Values ICollection that contains the values in the DbConnectionStringBuilder.' data-guid="cc068afe3c27be4b60d0d0ac4cd63399">取得在 DbConnectionStringBuilder 中包含值的 ICollection。 (繼承自 DbConnectionStringBuilder)。 回頁首 方法

---

  名稱 說明 Add DbConnectionStringBuilder.' data-guid="8fc3801d062d1ed1aab1bd08a5a531ca">將有指定索引鍵和數值的項目加入 DbConnectionStringBuilder。 (繼承自 DbConnectionStringBuilder)。 Clear EntityConnectionStringBuilder instance.' data-guid="585ae87f24f0f94be86ed3bee20d8576">清除 EntityConnectionStringBuilder 執行個體的內容。 (覆寫 DbConnectionStringBuilder.Clear()。) ClearPropertyDescriptors PropertyDescriptor objects on the associated DbConnectionStringBuilder.' data-guid="8913cc37d80c1a5c5d561a0ee9f2c029">清除相關聯 DbConnectionStringBuilder 上之 PropertyDescriptor 物件的集合。 (繼承自DbConnectionStringBuilder)。 ContainsKey EntityConnectionStringBuilder contains a specific key.' data-guid="3f7f3cb1e41e0b9e0b2db9d71d545314">判斷 EntityConnectionStringBuilder 是否包含特定索引鍵。 (覆寫DbConnectionStringBuilder.ContainsKey(String)。) Equals(Object) Object is equal to the current Object.' data-guid="d024d6da0149aefdf9704037df3d22c3">判斷指定的 Object 和目前的 Object 是否相等。 (繼承自 Object)。 EquivalentTo DbConnectionStringBuilder object with the connection information in the supplied object.' data-guid="e3ae851884c68066b2808c88a9edd0f4">比較此 DbConnectionStringBuilder 物件中的連接資訊與所提供之物件中的連接資訊。 (繼承自DbConnectionStringBuilder)。 Finalize operations before it is reclaimed by garbage collection." data-guid="dffa994726b89884494fb20a342cb288">允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。 GetHashCode function for a particular type. " data-guid="8dd85173562803f5021628dbb1fe85c7">做為特定型別的雜湊函式。 (繼承自 Object)。 GetProperties Hashtable with information about all the properties of this DbConnectionStringBuilder.' data-guid="83fb9dad602a319a2cc594cb685e6e03">以有關這個 DbConnectionStringBuilder 之所有屬性的資訊填入提供的 Hashtable。 (繼承自DbConnectionStringBuilder)。 GetType Type of the current instance.' data-guid="b1daf9b8691eb2e7c0f8b0ae88475e81">取得目前執行個體的 Type。 (繼承自 Object)。 MemberwiseClone Object.' data-guid="453ce3beb557e62accc082d3945920e2">建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。 Remove EntityConnectionStringBuilder instance. ' data-guid="d03ba7f4c3b39cc1b8ebec8bf8488bb6">將具有指定索引鍵的項目從 EntityConnectionStringBuilder 執行個體移除。 (覆寫DbConnectionStringBuilder.Remove(String)。) ShouldSerialize DbConnectionStringBuilder instance.' data-guid="d2d55bf6e2ef45da48b48d256db80f24">表示指定的索引鍵是否存在這個 DbConnectionStringBuilder 執行個體中。 (繼承自DbConnectionStringBuilder)。 ToString DbConnectionStringBuilder.' data-guid="4f75cc133e4b514396065dd60b7d51be">傳回與此 DbConnectionStringBuilder 相關聯的連接字串。 (繼承自 DbConnectionStringBuilder)。 TryGetValue EntityConnectionStringBuilder.' data-guid="7c0762e1fd0b62b6bfad720541035fd9">從這個 EntityConnectionStringBuilder 擷取對應至所提供索引鍵的值。 (覆寫DbConnectionStringBuilder.TryGetValue(String, Object)。) 回頁首 明確介面實作

---

  名稱 說明 ICollection.CopyTo ICollection to an Array, starting at a particular Array index.' data-guid="c75e59393bfdd31320fccd8e869d701c">從特定的 Array 索引開始，複製 ICollection 項目至 Array。 (繼承自DbConnectionStringBuilder)。 ICollection.IsSynchronized thread safe)." data-guid="a82cc1d66508822158056a95c7eec94f">ICollection is synchronized (thread safe).' data-guid="a82cc1d66508822158056a95c7eec94f">取得值，這個值會指出對 ICollection 的存取是否已同步處理 (執行緒安全)。 (繼承自DbConnectionStringBuilder)。 ICollection.SyncRoot can be used to synchronize access to the <span><span class="mtpsTagOuterHtml" ><span>ICollection</span></span></span>." data-guid="e13bc65b83dcf3dff5026a920e80c337">ICollection.' data-guid="e13bc65b83dcf3dff5026a920e80c337">取得可用來對 ICollection 進行同步存取的物件。 (繼承自DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetAttributes 傳回這個元件執行個體的自訂屬性集合。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetClassName 傳回這個元件執行個體的類別名稱。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetComponentName 傳回這個元件執行個體的名稱。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetConverter 傳回這個元件執行個體的型別轉換子。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetDefaultEvent 傳回這個元件執行個體的預設事件。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetDefaultProperty 傳回這個元件執行個體的預設屬性。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetEditor 傳回這個物件執行個體的指定型別編輯器。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetEvents() 傳回這個元件執行個體的事件。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetEvents(Attribute[]) 使用指定的屬性陣列做為篩選條件，以傳回這個元件執行個體的事件。 (繼承自DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetProperties() 傳回這個元件執行個體的屬性。 (繼承自 DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetProperties(Attribute[]) 使用屬性陣列做為篩選條件，以傳回這個元件執行個體的屬性。 (繼承自DbConnectionStringBuilder)。 ICustomTypeDescriptor.GetPropertyOwner 傳回物件，包含指定的屬性描述項所描述的屬性。 (繼承自DbConnectionStringBuilder)。 IDictionary.Add IDictionary object.' data-guid="95f97a4c986dbf17fb24f78d23036563">將隨附有索引鍵和值的項目加入至 IDictionary 物件。 (繼承自DbConnectionStringBuilder)。 IDictionary.Contains IDictionary object contains an element with the specified key.' data-guid="a13796ddaefb3e34444d04859159df04">判斷 IDictionary 物件是否包含具有指定索引鍵的項目。 (繼承自DbConnectionStringBuilder)。 IDictionary.GetEnumerator IDictionaryEnumerator object for the IDictionary object.' data-guid="fb0221d6cec12d9f68f847a0c9cacf08">傳回 IDictionary 物件的 IDictionaryEnumerator 物件。 (繼承自DbConnectionStringBuilder)。 IDictionary.Item 取得或設定具有指定索引鍵的元素。 (繼承自 DbConnectionStringBuilder)。 IDictionary.Remove IDictionary object.' data-guid="232623baae312b5075da7c3b7780115b">將有指定索引鍵的項目從 IDictionary 物件移除。 (繼承自DbConnectionStringBuilder)。 IEnumerable.GetEnumerator 傳回會逐一查看集合的列舉程式。 (繼承自 DbConnectionStringBuilder)。 回頁首 備註

---

範例

---

EntityConnectionStringBuilder in conjunction with a SqlConnectionStringBuilder.' data-guid="748b371eef6c2d759ce10d8b86e044ea">在下列範例中，會示範如何將 EntityConnectionStringBuilder 與 SqlConnectionStringBuilder 搭配使用。

C# VB

// Specify the provider name, server and database.
string providerName = "System.Data.SqlClient";
string serverName = ".";
string databaseName = "AdventureWorks";

// Initialize the connection string builder for the
// underlying provider.
SqlConnectionStringBuilder sqlBuilder =
    new SqlConnectionStringBuilder();

// Set the properties for the data source.
sqlBuilder.DataSource = serverName;
sqlBuilder.InitialCatalog = databaseName;
sqlBuilder.IntegratedSecurity = true;

// Build the SqlConnection connection string.
string providerString = sqlBuilder.ToString();

// Initialize the EntityConnectionStringBuilder.
EntityConnectionStringBuilder entityBuilder =
    new EntityConnectionStringBuilder();

//Set the provider name.
entityBuilder.Provider = providerName;

// Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString;

// Set the Metadata location.
entityBuilder.Metadata = @"res://*/AdventureWorksModel.csdl|
                            res://*/AdventureWorksModel.ssdl|
                            res://*/AdventureWorksModel.msl";
Console.WriteLine(entityBuilder.ToString());

using (EntityConnection conn =
    new EntityConnection(entityBuilder.ToString()))
{
    conn.Open();
    Console.WriteLine("Just testing the connection.");
    conn.Close();
}

版本資訊

---

.NET Framework

支援版本：4、3.5 SP1

.NET Framework Client Profile

支援版本：4
平台

---

Windows 7, Windows Vista SP1 (含) 以後版本, Windows XP SP3, Windows Server 2008 (不支援伺服器核心), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心), Windows Server 2003 SP2

.NET Framework 並不支援各種平台的所有版本。如需支援的版本的清單，請參閱.NET Framework 系統需求。 執行緒安全

---

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。 請參閱

---

參考

System.Data.EntityClient 命名空間 EntityConnection

其他資源

連接字串 (ADO.NET) Working with EntityClient