SqlConnectionStringBuilder Конструкторы

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

См. также раздел

• Общие сведения об ADO.NET

public:
 SqlConnectionStringBuilder(System::String ^ connectionString);

public SqlConnectionStringBuilder (string connectionString);

new System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.Data.SqlClient.SqlConnectionStringBuilder

Public Sub New (connectionString As String)

Параметры

Исключения

Примеры

В следующем примере конструктору объекта SqlConnectionStringBuilder предоставляется простая строка подключения SQL Server, а затем выполняется перебор всех пар «ключ-значение» в объекте. Обратите внимание, что коллекция предоставляет значения по умолчанию для каждого элемента. Также следует отметить, что класс SqlConnectionStringBuilder преобразует синонимы для хорошо известных ключей таким образом, чтобы они соответствовали хорошо известным именам.

using System.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);
        }
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As String In builder.Keys
                Console.WriteLine(key & "=" & builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: " & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: " & ex.Message)
        End Try
    End Sub
End Module

Комментарии

Класс SqlConnectionStringBuilder предоставляет фиксированную внутреннюю коллекцию пар «ключ-значение». Даже если в конструкторе предоставляется только небольшой набор возможных значений строки подключения, объект всегда предоставит значения по умолчанию для каждой пары «ключ-значение». При извлечении ConnectionString свойства объекта строка содержит только пары "ключ-значение", в которых значение не является значением по умолчанию для элемента.

См. также раздел

• Строки подключения (ADO.NET)
• Общие сведения об ADO.NET