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)

Исходный код:

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