SqlConnectionStringBuilder.Item[String] Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, связанное с указанным ключом. В языке 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
Ключ возвращаемого или задаваемого элемента.
Значение свойства
Значение, связанное с указанным ключом.
Исключения
Параметр keyword
является неопределенной ссылкой (Nothing
в Visual Basic).
Попытка добавить ключ, не существующий в списке доступных ключей.
Недопустимое значение в строке подключения (в данном случае ожидаемое логическое или числовое значение не было передано).
Примеры
В следующем примере кода в консольном приложении создается класс 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.