共用方式為


SqlConnectionStringBuilder 建構函式

定義

多載

SqlConnectionStringBuilder()

初始化 SqlConnectionStringBuilder 類別的新執行個體。

SqlConnectionStringBuilder(String)

初始化 SqlConnectionStringBuilder 類別的新執行個體。 所提供的連接字串會提供執行個體內部連接資訊的資料。

SqlConnectionStringBuilder()

初始化 SqlConnectionStringBuilder 類別的新執行個體。

public:
 SqlConnectionStringBuilder();
public SqlConnectionStringBuilder ();
Public Sub New ()

適用於

SqlConnectionStringBuilder(String)

初始化 SqlConnectionStringBuilder 類別的新執行個體。 所提供的連接字串會提供執行個體內部連接資訊的資料。

public:
 SqlConnectionStringBuilder(System::String ^ connectionString);
public SqlConnectionStringBuilder (string connectionString);
new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.Data.SqlClient.SqlConnectionStringBuilder
Public Sub New (connectionString As String)

參數

connectionString
String

物件內部連接資訊的基準。 剖析成名稱/值組。 無效索引鍵名稱會引發 KeyNotFoundException

例外狀況

連接字串內無效的索引鍵名稱。

連接字串中的無效值 (特別當必須是布林值或數值,但未提供這些值時)。

提供的 connectionString 無效。

範例

下列範例會在 SqlConnectionStringBuilder 物件的建構函式中提供簡單的 SQL Server 連接字串,然後逐一查看此物件內的所有索引鍵/值組。 請注意,此集合會提供每一個項目的預設值。 也請注意,SqlConnectionStringBuilder 類別會轉換已知索引鍵的同義資料表,使其與已知的名稱一致。

注意

這個範例包含了密碼,可示範 SqlConnectionStringBuilder 如何搭配連接字串使用。 我們建議在您的應用程式中使用 Windows 驗證。 如果您必須使用密碼,請勿在您的應用程式中包含硬式編碼的密碼。

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

備註

SqlConnectionStringBuilder 類別會提供索引鍵/值組的固定內部集合。 即使您只在建構函式中提供可能連接字串值的少量子集,此物件一定會針對每一個索引鍵/值組提供預設值。 ConnectionString擷取物件的 屬性時,字串只會包含索引鍵/值組,其中值不是專案的預設值。

適用於