DbConnectionStringBuilder.AppendKeyValuePair 方法

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

提供有效且安全的方法，將索引鍵和值附加至現有的 StringBuilder 物件。

多載

AppendKeyValuePair(StringBuilder, String, String)	提供有效且安全的方法，將索引鍵和值附加至現有的 StringBuilder 物件。
AppendKeyValuePair(StringBuilder, String, String, Boolean)	提供有效且安全的方法，將索引鍵和值附加至現有的 StringBuilder 物件。

AppendKeyValuePair(StringBuilder, String, String)

來源:

DbConnectionStringBuilder.cs

提供有效且安全的方法，將索引鍵和值附加至現有的 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)

參數

builder

StringBuilder

要加入機碼值組的 StringBuilder

keyword

String

要加入的索引鍵。

value

String

所提供的索引鍵值。

範例

如果某些程式已建立 連接字串，但現在應用程式必須對該 連接字串 執行簡單的修改，則只使用 StringBuilder 物件新增索引鍵/值組可能會更有效率。 開發人員不需要建立新的 DbConnectionStringBuilder，而是可以呼叫 AppendKeyValuePair 方法，傳入StringBuilder包含所提供 連接字串 的 。 下列程序顯示這項技術的簡單範例。

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

備註

此方法可讓開發人員使用 StringBuilder 建立索引鍵/值組的集合，讓您能夠在新增索引鍵/值組時利用 類別中包含的 DbConnectionStringBuilder 功能，而不需要產生建立和維護 DbConnectionStringBuilder 實例的額外負荷。 方法會 AppendKeyValuePair 正確格式化索引鍵和值，並將新的字串新增至提供的 StringBuilder。

另請參閱

• ADO.NET 中的連接字串
• ADO.NET 概觀 \(部分機器翻譯\)

AppendKeyValuePair(StringBuilder, String, String, Boolean)

來源:

DbConnectionStringBuilder.cs

提供有效且安全的方法，將索引鍵和值附加至現有的 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)

參數

builder

StringBuilder

要加入機碼值組的 StringBuilder

keyword

String

要加入的索引鍵。

value

String

所提供的索引鍵值。

useOdbcRules

Boolean

true 表示使用 {} 分隔欄位，false 表示使用引號。

範例

如果某些程式已建立 連接字串，但應用程式現在必須對該 連接字串 執行簡單的修改，則只使用 StringBuilder 物件新增索引鍵/值組可能會更有效率。 開發人員不需要建立新的 DbConnectionStringBuilder，而是可以呼叫 AppendKeyValuePair 方法，傳入StringBuilder包含所提供 連接字串 的 。 下列程序顯示這項技術的簡單範例，使用 ODBC 規則來參考值。

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

備註

此方法可讓開發人員使用 StringBuilder 建立索引鍵/值組的集合，以在新增索引鍵/值組時利用 類別中包含的 DbConnectionStringBuilder 功能，而不需要產生建立和維護 DbConnectionStringBuilder 實例的額外負荷。 方法會 AppendKeyValuePair 正確格式化索引鍵和值，並將新的字串新增至提供的 StringBuilder。

雖然大部分數據源都可讓您使用引號分隔欄位，但 ODBC 不會-- 針對 ODBC 連接字串，您必須使用大括弧 () {} 。 若要使用 DbConnectionStringBuilder ODBC 規則分隔字位，請將 useOdbcRules 參數設定為 true。

另請參閱

• ADO.NET 中的連接字串
• ADO.NET 概觀 \(部分機器翻譯\)