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 свойства объекта строка содержит только пары "ключ-значение", в которых значение не является значением по умолчанию для элемента.