SqlConnectionStringBuilder.Item[String] Свойство

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает значение, связанное с указанным ключом. В языке C# это свойство является индексатором.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

public override object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(keyword As String) As Object

Параметры

keyword

String

Ключ возвращаемого или задаваемого элемента.

Значение свойства

Object

Значение, связанное с указанным ключом.

Исключения

ArgumentNullException

Параметр keyword является неопределенной ссылкой (Nothing в Visual Basic).

KeyNotFoundException

Попытка добавить ключ, не существующий в списке доступных ключей.

FormatException

Недопустимое значение в строке подключения (в данном случае ожидаемое логическое или числовое значение не было передано).

Примеры

В следующем примере кода в консольном приложении создается класс SqlConnectionStringBuilder, после чего в его строку подключения с помощью свойства Item[] добавляются пары «ключ-значение».

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder();
        builder["Data Source"] = "(local)";
        builder["Integrated Security"] = true;
        builder["Initial Catalog"] = "AdventureWorks";

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = ".";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();
        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }
}

Комментарии

Поскольку класс SqlConnectionStringBuilder содержит словарь фиксированного размера, попытка добавить к нему ключ, не существующий в словаре, вызывает исключение KeyNotFoundException.