DbConnectionStringBuilder.AppendKeyValuePair メソッド

定義

名前空間:

System.Data.Common

アセンブリ:

netstandard.dll, 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 の概要