AppendKeyValuePair(StringBuilder, String, String, Boolean)

Метод добавляет пару «ключ/значение» в указанную строку подключения с заданным разделителем пар «ключ/значение».

Метод позволяет с помощью объекта StringBuilder создать коллекцию пар «ключ/значение» без дополнительных издержек, связанных с созданием и поддержкой экземпляра DbConnectionStringBuilder. Метод AppendKeyValuePair правильно форматирует символьную строку «ключ/значение» и добавляет её к указанному объекту StringBuilder.

Синтаксис
public static void AppendKeyValuePair(
  StringBuilder builder,
  string keyword,
  string value,
  bool useOdbcRules
);
      

builder – объект StringBuilder, в который надо добавить пару «ключ/значение».

keyword – имя добавляемого ключа.

value – значение добавляемого ключа.

UseOdbcRules – тип разделителя:

  • true – использовать фигурные скобки {} для разделения полей;

  • false – использовать двойные кавычки.

Возвращаемое значение

Значение типа void.

Исключения
ArgumentNullException Null-значение параметра builder или keyword.
ArgumentException Недопустимое значение параметра builder или keyword.
Пример
// C#
using System;
using System.Data;
using System.Data.Common;
using System.Text;

class ConnectionStringBuilderSample
{
  static void Main()
  {
    // Создание объекта StringBuilder
    StringBuilder builder = new StringBuilder();
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Dsn",
      "Linter 6.0 Unicode", true);
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Uid",
      "odbc user;", true);
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pwd",
      "odbc password;", true);
    // Отображение полученной строки подключения
    Console.WriteLine(builder.ToString());
    Console.WriteLine();
    Console.WriteLine("Нажмите клавишу Ввод для завершения");
    Console.ReadLine();
  }
}

Результат выполнения примера:

Dsn=Linter 6.0 Unicode;Uid={odbc user;};Pwd={odbc password;}