Поделиться через


DbConnectionStringBuilder.AppendKeyValuePair Метод

Определение

Обеспечивает эффективный и безопасный способ добавления ключа и значения в существующий объект StringBuilder.

Перегрузки

AppendKeyValuePair(StringBuilder, String, String)

Обеспечивает эффективный и безопасный способ добавления ключа и значения в существующий объект StringBuilder.

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Обеспечивает эффективный и безопасный способ добавления ключа и значения в существующий объект StringBuilder.

AppendKeyValuePair(StringBuilder, String, String)

Исходный код:
DbConnectionStringBuilder.cs
Исходный код:
DbConnectionStringBuilder.cs
Исходный код:
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);
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)

Исходный код:
DbConnectionStringBuilder.cs
Исходный код:
DbConnectionStringBuilder.cs
Исходный код:
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);
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.

См. также раздел

Применяется к