SqlConnectionStringBuilder 构造函数

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

重载

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。

例外

KeyNotFoundException

连接字符串中包含无效的键名。

FormatException

连接字符串中包含无效的值（具体而言，需要使用布尔值或数值，但字符串中并未提供）。

ArgumentException

所提供的 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检索对象的 属性时，字符串仅包含键/值对，其中值不是项的默认值。