DbConnectionStringBuilder.Add(String, Object) Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

Kaynak:

DbConnectionStringBuilder.cs

öğesine belirtilen anahtar ve değere DbConnectionStringBuildersahip bir girdi ekler.

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)

Parametreler

keyword

String

öğesine eklenecek DbConnectionStringBuilderanahtar.

value

Object

Belirtilen anahtarın değeri.

Özel durumlar

ArgumentNullException

keyword bir null başvurudur (Nothing Visual Basic'te).

NotSupportedException

DbConnectionStringBuilder salt okunurdur.

-veya-

sabit DbConnectionStringBuilder bir boyuta sahiptir.

Örnekler

Aşağıdaki örnek yeni DbConnectionStringBuilder bir oluşturur ve öğeler ekler. Kod ayrıca yöntemini kullanarak Add var olan bir öğenin üzerine yazmayı gösterir ve bir oluşturan ArgumentNullExceptionaçıklamalı bir blok içerir.

Not

Bu örnek, bağlantı dizeleriyle nasıl DbConnectionStringBuilder çalıştığını gösteren bir parola içerir. Uygulamalarınızda Windows Kimlik Doğrulaması kullanmanızı öneririz. Bir parola kullanmanız gerekiyorsa, uygulamanıza sabit kodlanmış bir parola eklemeyin.

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

Açıklamalar

Item[] özelliği, sözlükte bulunmayan bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanılabilir. Örneğin: myCollection["myNonexistentKey"] = myValue.

Add null (Nothing Visual Basic'te) anahtarı geçirerek yöntemini çağırmak bir ArgumentNullExceptionoluşturur. Ancak, null bir değer geçirerek yöntemini çağırmak Add anahtar/değer çiftini kaldırır.

Ayrıca bkz.

• ADO.NET'da Bağlantı Dizeleri
• ADO.NET’e Genel Bakış