DbConnectionStringBuilder.AppendKeyValuePair Метод

Определение

Пространство имен:

System.Data.Common

Сборка:

System.Data.dll

Предоставляет эффективный и безопасный способ добавления ключа и значения к существующему объекту 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);

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)

Предоставляет эффективный и безопасный способ добавления ключа и значения к существующему объекту 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