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

Определение

Пространство имен:

System.Data.SqlClient

Сборка:

System.Data.dll

Инициализирует новый экземпляр класса SqlConnectionStringBuilder.

Перегрузки

SqlConnectionStringBuilder()	Инициализирует новый экземпляр класса SqlConnectionStringBuilder.
SqlConnectionStringBuilder(String)	Инициализирует новый экземпляр класса SqlConnectionStringBuilder. Предоставленная строка подключения содержит данные для сведений о внутреннем подключении экземпляра.

SqlConnectionStringBuilder()

Инициализирует новый экземпляр класса SqlConnectionStringBuilder.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

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

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

SqlConnectionStringBuilder(String)

Инициализирует новый экземпляр класса SqlConnectionStringBuilder. Предоставленная строка подключения содержит данные для сведений о внутреннем подключении экземпляра.

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)

Параметры

connectionString

String

Основа для сведений о внутреннем подключении объекта. Разбито на пары имя-значение. Недопустимое имя ключа вызывает исключение KeyNotFoundException.

Исключения

KeyNotFoundException

Недопустимое имя ключа в строке подключения.

FormatException

Недопустимое значение в строке подключения (в данном случае ожидаемое логическое или числовое значение не было передано).

ArgumentException

Поставлено недопустимое значение connectionString.

Примеры

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

Примечание

В этом примере для демонстрации взаимодействия класса SqlConnectionStringBuilder со строками подключения используется пароль. В приложениях рекомендуется использовать аутентификацию Windows. Если необходимо использовать пароль, то не следует включать в приложение пароли, жестко заданные в коде.

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