DbConnectionStringBuilder.Add(String, Object) Метод

Определение

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

System.Data.Common

Сборка:

System.Data.Common.dll

Исходный код:

DbConnectionStringBuilder.cs

Добавляет запись с указанными ключом и значением в DbConnectionStringBuilder.

public:
 void Add(System::String ^ keyword, System::Object ^ value);

public void Add (string keyword, object value);

member this.Add : string * obj -> unit

Public Sub Add (keyword As String, value As Object)

Параметры

keyword

String

Ключ, добавляемый в DbConnectionStringBuilder.

value

Object

Значение заданного ключа.

Исключения

ArgumentNullException

Параметр keyword является неопределенной ссылкой (Nothing в Visual Basic).

NotSupportedException

Объект DbConnectionStringBuilder доступен только для чтения.

-или-

DbConnectionStringBuilder имеет фиксированный размер.

Примеры

В следующем примере создается новый DbConnectionStringBuilder объект и добавляются элементы. Код также демонстрирует перезапись существующего элемента с помощью Add метода и включает блок комментариев, который вызывает исключение ArgumentNullException.

Примечание

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

static void Main()
{
    try
    {
        DbConnectionStringBuilder builder =
            new DbConnectionStringBuilder();
        builder.Add("Data Source", "ServerName");
        builder.Add("Initial Catalog", "TheDatabase");
        builder.Add("User ID", "UserName");
        builder.Add("Password", "*******");
        builder.Add("Command Logging", false);

        // Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName");

        // The following code would trigger
        // an ArgumentNullException:
        // builder.Add(null, "Some Value");

        Console.WriteLine(builder.ConnectionString);
    }
    catch (ArgumentNullException)
    {
        Console.WriteLine("Null key values are not allowed.");
    }

    Console.WriteLine("Press Enter to continue.");
    Console.ReadLine();
}

Sub Main()
    Try
        Dim builder As New DbConnectionStringBuilder
        builder.Add("Data Source", "ServerName")
        builder.Add("Initial Catalog", "TheDatabase")
        builder.Add("User ID", "UserName")
        builder.Add("Password", "*******")
        builder.Add("Command Logging", False)

        ' Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName")

        ' The following code would trigger 
        ' an ArgumentNullException.
        ' builder.Add(Nothing, "Some Value")

        Console.WriteLine(builder.ConnectionString)

    Catch ex As ArgumentNullException
        Console.WriteLine("Null key values are not allowed.")
    End Try

    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
End Sub

Комментарии

Свойство Item[] также можно использовать для добавления новых элементов, задав значение ключа, не существующего в словаре. Например: myCollection["myNonexistentKey"] = myValue.

Add Вызов метода путем передачи ключа NULL (Nothing в Visual Basic) вызывает исключение ArgumentNullException. Однако вызов Add метода путем передачи значения NULL удаляет пару "ключ-значение".

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

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