DbConnectionStringBuilder.AppendKeyValuePair 方法

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)

參數

範例

如果某個程序已經建立了連接字串，但現在應用程式必須對該連接字串做簡單修改，使用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

備註

此方法讓使用 a StringBuilder 建立一組鍵值對的開發者，能利用類別中新增鍵值對時的 DbConnectionStringBuilder 特性，而無需承擔建立與維護 DbConnectionStringBuilder 實例的額外負擔。 此 AppendKeyValuePair 方法正確格式化鍵與值，並將新字串加入所提供的 StringBuilder。

另請參閱

• ADO.NET 中的連接字串
• ADO.NET 概觀

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)

參數

範例

如果某個程序已經建立了連接字串，但現在應用程式必須對該連接字串做簡單修改，可能更有效率地用 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

備註

此方法允許使用 a StringBuilder 建立鍵值對集合的開發者，在新增鍵值對時能利用類別中包含的 DbConnectionStringBuilder 功能，而無需承擔建立與維護 DbConnectionStringBuilder 實例的額外負擔。 此 AppendKeyValuePair 方法正確格式化鍵與值，並將新字串加入所提供的 StringBuilder。

雖然大多數資料來源允許使用引號來區隔欄位，但 ODBC 不允許——對於 ODBC 的連接字串，你必須使用大括號（{}）。 為了讓 使用 DbConnectionStringBuilder ODBC 規則來劃分欄位，將參數設 useOdbcRules 為 true。

另請參閱

• ADO.NET 中的連接字串
• ADO.NET 概觀