DbConnectionStringBuilder.AppendKeyValuePair Метод

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

DbConnectionStringBuilder.cs

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

DbConnectionStringBuilder.cs

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

DbConnectionStringBuilder.cs

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)

Параметры

Примеры

Если какой-либо процесс создал строка подключения, но теперь приложение должно выполнить простое изменение этого строка подключения, может быть эффективнее просто добавить пару "ключ-значение" с помощью 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

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

DbConnectionStringBuilder.cs

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

DbConnectionStringBuilder.cs

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

DbConnectionStringBuilder.cs

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)

Параметры

Примеры

Если какой-либо процесс создал строка подключения, но теперь приложение должно выполнить простое изменение этого строка подключения, было бы эффективнее просто добавить пару "ключ-значение" с помощью 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