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

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

System.Data.Odbc v9.0.0-preview.3.24172.9

Исходный код:

OdbcConnectionStringbuilder.cs

Возвращает или задает значение, связанное с указанным ключом. В языке 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

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

Исключения

ArgumentException

Строка подключения неправильно отформатирована (возможно отсутствует обязательный знак равенства "=" в паре "ключ/значение").

ArgumentNullException

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

Примеры

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

using System.Data.Odbc;

class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder =
            new OdbcConnectionStringBuilder();
        // Set up a connection string for a text file.
        builder["Driver"] = "Microsoft Text Driver (*.txt; *.csv)";
        builder["dbq"] = "C:\\TextFilesFolder";
        builder["Extension"] = "asc,csv,tab,txt";

        // Overwrite the existing value for the dbq value,
        // because it already exists within the collection.
        builder["dbq"] = "D:\\";

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

Imports System.Data.Odbc    

Module Module1
  Sub Main()
    Dim builder As New OdbcConnectionStringBuilder
    ' Set up a connection string for a text file.
    builder.Item("Driver") = "Microsoft Text Driver (*.txt; *.csv)"
    ' Note that Item is the default property, so 
    ' you need not include it in the reference.
    builder("dbq") = "C:\TextFilesFolder"
    builder.Item("Extension") = "asc,csv,tab,txt"

    ' Overwrite the existing value for the dbq value, 
    ' because it already exists within the collection.
    builder.Item("dbq") = "D:\"

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

Комментарии

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

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

• Построители строк подключения
• Строки подключения в ADO.NET