EntityConnectionStringBuilder 類別

定義

命名空間:

System.Data.EntityClient

組件:

System.Data.Entity.dll

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

public ref class EntityConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

public sealed class EntityConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

type EntityConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class EntityConnectionStringBuilder
Inherits DbConnectionStringBuilder

繼承

Object

DbConnectionStringBuilder

EntityConnectionStringBuilder

範例

下列範例示範如何搭配 EntityConnectionStringBuilder 使用 SqlConnectionStringBuilder。

// 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();
}

' Specify the provider name, server and database.
Dim providerName As String = "System.Data.SqlClient"
Dim serverName As String = "."
Dim databaseName As String = "AdventureWorks"

' Initialize the connection string builder for the
' underlying provider.
Dim sqlBuilder As New SqlConnectionStringBuilder

' Set the properties for the data source.
sqlBuilder.DataSource = serverName
sqlBuilder.InitialCatalog = databaseName
sqlBuilder.IntegratedSecurity = True

' Build the SqlConnection connection string.
Dim providerString As String = sqlBuilder.ToString

' Initialize the EntityConnectionStringBuilder.
Dim entityBuilder As New EntityConnectionStringBuilder

'Set the provider name.
entityBuilder.Provider = providerName
' Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString
' Set the Metadata location to the current directory.
entityBuilder.Metadata = "res://*/AdventureWorksModel.csdl|" & _
                            "res://*/AdventureWorksModel.ssdl|" & _
                            "res://*/AdventureWorksModel.msl"

Console.WriteLine(entityBuilder.ToString)

Using conn As EntityConnection = New EntityConnection(entityBuilder.ToString)
    conn.Open()
    Console.WriteLine("Just testing the connection.")
    conn.Close()
End Using

備註

連接字串產生器 (Builder) 可讓開發人員使用類別的屬性和方法，以程式設計方式建立語法正確的連接字串，以及剖析和重新建置現有的連接字串。 連接字串產生器提供強型別 (Strongly Typed) 屬性，這些屬性對應到已知關鍵字/值組。 必須建立連接字串做為應用程式一部分的開發人員可以使用 EntityConnectionStringBuilder 類別來建置及修改連接字串。

EntityConnectionStringBuilder 執行有效關鍵字/值組的檢查，其中每組都會公開 (Expose) 為 EntityConnectionStringBuilder 屬性值。

注意

基礎資料來源的連接字串會由 ProviderConnectionString 屬性提供。 不會在提供的提供者連接字串中檢查有效關鍵字/值組。

建構函式

EntityConnectionStringBuilder()	初始化 EntityConnectionStringBuilder 類別的新執行個體。
EntityConnectionStringBuilder(String)	使用提供的連接字串初始化 EntityConnectionStringBuilder 類別的新執行個體。

屬性

BrowsableConnectionString	取得或設定值，指出 ConnectionString 屬性是否會顯示在 Visual Studio 設計工具中。 (繼承來源 DbConnectionStringBuilder)
ConnectionString	取得或設定與 DbConnectionStringBuilder 相關聯的連接字串。 (繼承來源 DbConnectionStringBuilder)
Count	取得 ConnectionString 屬性內所包含的索引鍵目前數目。 (繼承來源 DbConnectionStringBuilder)
IsFixedSize	取得值，指出 EntityConnectionStringBuilder 是否有固定的大小。
IsReadOnly	取得值，這個值表示 DbConnectionStringBuilder 是否為唯讀。 (繼承來源 DbConnectionStringBuilder)
Item[String]	取得或設定與指定之索引鍵相關聯的值。 在 C# 中，這個屬性是索引子 (Indexer)。
Keys	取得 ICollection 中包含索引鍵的 EntityConnectionStringBuilder。
Metadata	取得或設定連接字串中的中繼資料位置。
Name	取得或設定區段的名稱，如在組態檔中的定義。
Provider	取得或設定 連接字串 中基礎 .NET Framework 數據提供者的名稱。
ProviderConnectionString	取得或設定內部的提供者特定連接字串。
Values	取得包含 ICollection 中之值的 DbConnectionStringBuilder。 (繼承來源 DbConnectionStringBuilder)

方法

Add(String, Object)	將有指定索引鍵和數值項目加入 DbConnectionStringBuilder 中。 (繼承來源 DbConnectionStringBuilder)
Clear()	清除 EntityConnectionStringBuilder 執行個體的內容。
ClearPropertyDescriptors()	清除在相關聯 DbConnectionStringBuilder 上的 PropertyDescriptor 物件集合。 (繼承來源 DbConnectionStringBuilder)
ContainsKey(String)	判斷 EntityConnectionStringBuilder 是否包含特定索引鍵。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
EquivalentTo(DbConnectionStringBuilder)	比較在這個 DbConnectionStringBuilder 物件中的連接資訊和提供之物件中的連接資訊。 (繼承來源 DbConnectionStringBuilder)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperties(Hashtable)	以這個 DbConnectionStringBuilder 之所有屬性的相關資訊填滿提供的 Hashtable。 (繼承來源 DbConnectionStringBuilder)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Remove(String)	從 EntityConnectionStringBuilder 執行個體移除具有指定之索引鍵的項目。
ShouldSerialize(String)	指出這個 DbConnectionStringBuilder 執行個體中，是否存在指定的索引鍵。 (繼承來源 DbConnectionStringBuilder)
ToString()	傳回與這個 DbConnectionStringBuilder 相關聯的連接字串。 (繼承來源 DbConnectionStringBuilder)
TryGetValue(String, Object)	從這個 EntityConnectionStringBuilder 擷取對應到所提供之索引鍵的值。

明確介面實作

ICollection.CopyTo(Array, Int32)	從特定的 ICollection 索引開始，將 Array 的項目複製到 Array。 (繼承來源 DbConnectionStringBuilder)
ICollection.IsSynchronized	取得值，這個值表示對 ICollection 的存取是否同步 (安全執行緒)。 (繼承來源 DbConnectionStringBuilder)
ICollection.SyncRoot	取得可用以同步存取 ICollection 的物件。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	傳回元件之這個執行個體的自訂屬性集合。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	傳回這個元件執行個體的類別名稱。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	傳回這個元件執行個體的名稱。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	傳回這個元件執行個體的類型轉換子。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	傳回這個元件執行個體的預設事件。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	傳回這個元件執行個體的屬性。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	傳回元件的這個執行個體之指定類型編輯器。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	傳回這個元件執行個體的事件。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	使用指定屬性陣列做為篩選條件傳回元件之執行個體的事件。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	傳回元件之這個執行個體的屬性。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	使用屬性陣列做為篩選條件，傳回這個元件執行個體的屬性。 (繼承來源 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	傳回物件，包含指定的屬性描述項所描述的屬性。 (繼承來源 DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	將隨附有索引鍵和值的項目加入至 IDictionary 物件。 (繼承來源 DbConnectionStringBuilder)
IDictionary.Contains(Object)	判斷 IDictionary 物件是否包含具有指定索引鍵的項目。 (繼承來源 DbConnectionStringBuilder)
IDictionary.GetEnumerator()	傳回 IDictionary 物件的 IDictionaryEnumerator 物件。 (繼承來源 DbConnectionStringBuilder)
IDictionary.Item[Object]	取得或設定具有指定索引鍵的項目。 (繼承來源 DbConnectionStringBuilder)
IDictionary.Remove(Object)	從 IDictionary 物件中移除具有指定索引鍵的項目。 (繼承來源 DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	傳回逐一查看集合的列舉值。 (繼承來源 DbConnectionStringBuilder)

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。

另請參閱

• EntityConnection
• 連接字串
• 使用 EntityClient