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

Определение

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

public virtual object this[string keyword] { get; set; }
[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }

Параметры

keyword
String

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

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

Значение, связанное с указанным ключом. Если указанный ключ не найден, при попытке его получения возвращается пустая ссылка (Nothing в Visual Basic), а при попытке задания создается новый элемент с использованием указанного ключа.

Передача пустого ключа (Nothing в Visual Basic) порождает ArgumentNullException. При присвоении значения NULL удаляется пара "ключ-значение".

Атрибуты

Исключения

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

Свойство задано, а значение DbConnectionStringBuilder доступно только для чтения.

-или-

Свойство задано, keyword не существует в коллекции, а DbConnectionStringBuilder имеет фиксированный размер.

Примеры

Следующее консольное приложение создает новый DbConnectionStringBuilder объект и добавляет пары "ключ-значение" в строка подключения с помощью Item[] свойства .

static void Main()
{
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder["Data Source"] = "(local)";

    // Note that Item is the indexer, so
    // you do not include it in the reference.
    builder["integrated security"] = true;
    builder["Initial Catalog"] = "AdventureWorks";

    // Overwrite the existing value for the Data Source key,
    // because it already exists within the collection.
    builder["Data Source"] = ".";

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

Комментарии

При установке этого свойства значение заменяется, если указанный ключ уже существует в словаре; в противном случае создается новый элемент .

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

Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

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