DbConnectionStringBuilder.AppendKeyValuePair メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
既存の StringBuilder オブジェクトにキーと値を追加する、効率的かつ安全な方法を提供します。
オーバーロード
AppendKeyValuePair(StringBuilder, String, String) |
既存の StringBuilder オブジェクトにキーと値を追加する、効率的かつ安全な方法を提供します。 |
AppendKeyValuePair(StringBuilder, String, String, Boolean) |
既存の StringBuilder オブジェクトにキーと値を追加する、効率的かつ安全な方法を提供します。 |
AppendKeyValuePair(StringBuilder, String, String)
既存の 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);
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に新しい文字列を追加します。
こちらもご覧ください
適用対象
AppendKeyValuePair(StringBuilder, String, String, Boolean)
既存の 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);
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
設定します。
こちらもご覧ください
適用対象
.NET