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)

Source:

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 对象添加键/值对可能更有效。 开发人员可以调用 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。

另请参阅

• ADO.NET 中的连接字符串
• ADO.NET 概述

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Source:

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 对象添加键/值对可能更有效。 开发人员可以调用 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 规则分隔字段，请将 useOdbcRules 参数设置为 true。

另请参阅

• ADO.NET 中的连接字符串
• ADO.NET 概述