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 接続文字列を使用しません。中かっこ ({}) を使用する必要があります。 ODBC ルールを使用してフィールドを DbConnectionStringBuilder 区切るには、 パラメーターを useOdbcRules に true設定します。

こちらもご覧ください

• ADO.NET での接続文字列
• ADO.NET の概要