DbConnectionStringBuilder.AppendKeyValuePair 方法

定义

提供了一种有效而安全的方法,用于将键和值附加到现有的 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 可能更有效。 开发人员可以调用 AppendKeyValuePair 方法,而不是创建新的 DbConnectionStringBuilder,而是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 对象添加键/值对可能更有效。 开发人员可以调用 AppendKeyValuePair 方法,而不是创建新的 DbConnectionStringBuilder,而是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 规则分隔字段,请将 参数设置为 useOdbcRulestrue

另请参阅

适用于