Bagikan melalui


DbConnectionStringBuilder.Add(String, Object) Metode

Definisi

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

keyword adalah referensi null (Nothing di Visual Basic).

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.

Berlaku untuk

Lihat juga