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

Определение

Возвращает или задает значение, связанное с указанным ключом.Gets or sets the value associated with the specified key. В языке C# это свойство является индексатором.In C#, this property is the indexer.

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

Ключ возвращаемого или задаваемого элемента.The key of the item to get or set.

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

Значение, связанное с указанным ключом.The value associated with the specified key.

Исключения

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

Попытка добавить ключ, не существующий в списке доступных ключей.Tried to add a key that does not exist within the available keys.

Недопустимое значение в строке подключения (в данном случае ожидаемое логическое или числовое значение не было передано).Invalid value within the connection string (specifically, a Boolean or numeric value was expected but not supplied).

Примеры

В следующем примере кода в консольном приложении создается класс SqlConnectionStringBuilder, после чего в его строку подключения с помощью свойства Item[String] добавляются пары «ключ-значение».The following code, in a console application, creates a new SqlConnectionStringBuilder and adds key/value pairs to its connection string, using the Item[String] property.

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();
    }
}
Module Module1
    Sub Main()
        Dim builder As New SqlConnectionStringBuilder
        builder.Item("Data Source") = "(local)"
        ' Item is the default property, so 
        ' you needn't include it in the reference.
        builder("Integrated Security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the Data Source value.
        builder.Item("Data Source") = "."

        Console.WriteLine(builder.ConnectionString)
        Console.WriteLine()
        Console.WriteLine("Press Enter to continue.")
        Console.ReadLine()
    End Sub
End Module

Комментарии

Поскольку класс SqlConnectionStringBuilder содержит словарь фиксированного размера, попытка добавить к нему ключ, не существующий в словаре, вызывает исключение KeyNotFoundException.Because the SqlConnectionStringBuilder contains a fixed-size dictionary, trying to add a key that does not exist within the dictionary throws a KeyNotFoundException.

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

Дополнительно