DbConnectionStringBuilder.Add(String, Object) Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Sumber:

DbConnectionStringBuilder.cs

Menambahkan entri dengan kunci dan nilai yang ditentukan ke DbConnectionStringBuilderdalam .

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)

Parameter

keyword

String

Kunci untuk ditambahkan ke DbConnectionStringBuilder.

value

Object

Nilai untuk kunci yang ditentukan.

Pengecualian

ArgumentNullException

keyword adalah referensi null (Nothing di Visual Basic).

NotSupportedException

DbConnectionStringBuilder bersifat baca-saja.

-atau-

memiliki DbConnectionStringBuilder ukuran tetap.

Contoh

Contoh berikut membuat baru DbConnectionStringBuilder dan menambahkan item. Kode ini juga menunjukkan penimpaan item yang ada menggunakan Add metode , dan menyertakan blok yang dikomentari yang akan melemparkan ArgumentNullException.

Catatan

Contoh ini mencakup kata sandi untuk menunjukkan cara DbConnectionStringBuilder kerja dengan string koneksi. Di aplikasi Anda, kami sarankan Anda menggunakan Autentikasi Windows. Jika Anda harus menggunakan kata sandi, jangan sertakan kata sandi yang dikodekan secara permanen dalam aplikasi Anda.

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

Keterangan

Item[] Properti juga dapat digunakan untuk menambahkan elemen baru dengan mengatur nilai kunci yang tidak ada dalam kamus. Misalnya: myCollection["myNonexistentKey"] = myValue.

Memanggil Add metode dengan meneruskan kunci null (Nothing di Visual Basic) melemparkan ArgumentNullException. Namun, memanggil Add metode dengan meneruskan nilai null akan menghapus pasangan kunci/nilai.

Lihat juga

• String Koneksi dalam ADO.NET
• Ringkasan ADO.NET