DbConnectionStringBuilder.AppendKeyValuePair Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Menyediakan cara yang efisien dan aman untuk menambahkan kunci dan nilai ke objek yang ada StringBuilder .

Overload

AppendKeyValuePair(StringBuilder, String, String)	Menyediakan cara yang efisien dan aman untuk menambahkan kunci dan nilai ke objek yang ada StringBuilder .
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Menyediakan cara yang efisien dan aman untuk menambahkan kunci dan nilai ke objek yang ada StringBuilder .

AppendKeyValuePair(StringBuilder, String, String)

Sumber:

DbConnectionStringBuilder.cs

Menyediakan cara yang efisien dan aman untuk menambahkan kunci dan nilai ke objek yang ada StringBuilder .

public:
 static void AppendKeyValuePair(System::Text::StringBuilder ^ builder, System::String ^ keyword, System::String ^ value);

public static void AppendKeyValuePair (System.Text.StringBuilder builder, string keyword, string? value);

static member AppendKeyValuePair : System.Text.StringBuilder * string * string -> unit

Public Shared Sub AppendKeyValuePair (builder As StringBuilder, keyword As String, value As String)

Parameter

builder

StringBuilder

yang StringBuilder akan ditambahkan pasangan kunci/nilai.

keyword

String

Kunci yang akan ditambahkan.

value

String

Nilai untuk kunci yang disediakan.

Contoh

Jika beberapa proses telah membuat string koneksi, tetapi sekarang aplikasi harus melakukan modifikasi sederhana pada string koneksi tersebut, mungkin lebih efisien untuk hanya menambahkan pasangan kunci/nilai menggunakan StringBuilder objek . Alih-alih membuat baruDbConnectionStringBuilder, pengembang dapat memanggil AppendKeyValuePair metode , meneruskan StringBuilder yang berisi string koneksi yang disediakan. Prosedur berikut menunjukkan contoh sederhana dari teknik ini.

public string AddPooling(string connectionString)
{
    StringBuilder builder = new StringBuilder(connectionString);
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pooling", "true");
    return builder.ToString();
}

Public Function AddPooling(ByVal connectionString As String) As String
    Dim builder As New StringBuilder(connectionString)
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pooling", "True")
    Return builder.ToString()
End Function

Keterangan

Metode ini memungkinkan pengembang menggunakan StringBuilder untuk membuat kumpulan pasangan kunci/nilai untuk dapat memanfaatkan fitur yang disertakan dalam DbConnectionStringBuilder kelas saat Anda menambahkan pasangan kunci/nilai, tanpa harus menimbulkan overhead untuk membuat dan memelihara DbConnectionStringBuilder instans. Metode memformat AppendKeyValuePair kunci dan nilai dengan benar dan menambahkan string baru ke yang disediakan StringBuilder.

Lihat juga

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

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Sumber:

DbConnectionStringBuilder.cs

Menyediakan cara yang efisien dan aman untuk menambahkan kunci dan nilai ke objek yang ada StringBuilder .

public:
 static void AppendKeyValuePair(System::Text::StringBuilder ^ builder, System::String ^ keyword, System::String ^ value, bool useOdbcRules);

public static void AppendKeyValuePair (System.Text.StringBuilder builder, string keyword, string? value, bool useOdbcRules);

static member AppendKeyValuePair : System.Text.StringBuilder * string * string * bool -> unit

Public Shared Sub AppendKeyValuePair (builder As StringBuilder, keyword As String, value As String, useOdbcRules As Boolean)

Parameter

builder

StringBuilder

yang StringBuilder akan ditambahkan pasangan kunci/nilai.

keyword

String

Kunci yang akan ditambahkan.

value

String

Nilai untuk kunci yang disediakan.

useOdbcRules

Boolean

true untuk digunakan {} untuk memisahkan bidang, false untuk menggunakan tanda kutip.

Contoh

Jika beberapa proses telah membuat string koneksi, tetapi sekarang aplikasi harus melakukan modifikasi sederhana pada string koneksi tersebut, mungkin lebih efisien untuk hanya menambahkan pasangan kunci/nilai menggunakan StringBuilder objek . Alih-alih membuat baruDbConnectionStringBuilder, pengembang dapat memanggil AppendKeyValuePair metode , meneruskan StringBuilder yang berisi string koneksi yang disediakan. Prosedur berikut menunjukkan contoh sederhana teknik ini, menggunakan aturan ODBC untuk mengutip nilai.

public string AddPooling(string connectionString)
{
    StringBuilder builder = new StringBuilder(connectionString);
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pooling", "true");
    return builder.ToString();
}

Public Function AddPooling(ByVal connectionString As String) As String
    Dim builder As New StringBuilder(connectionString)
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pooling", "True")
    Return builder.ToString()
End Function

Keterangan

Metode ini memungkinkan pengembang menggunakan StringBuilder untuk membuat kumpulan pasangan kunci/nilai untuk dapat memanfaatkan fitur yang disertakan dalam DbConnectionStringBuilder kelas saat menambahkan pasangan kunci/nilai, tanpa harus menimbulkan overhead untuk membuat dan memelihara DbConnectionStringBuilder instans. Metode memformat AppendKeyValuePair kunci dan nilai dengan benar dan menambahkan string baru ke yang disediakan StringBuilder.

Meskipun sebagian besar sumber data memungkinkan Anda memisahkan bidang dengan menggunakan tanda kutip, ODBC tidak --untuk string koneksi ODBC, Anda harus menggunakan kurung kurawal ({}). Untuk memiliki DbConnectionStringBuilder aturan ODBC penggunaan untuk memisahkan bidang, atur useOdbcRules parameter ke true.

Lihat juga

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