OdbcConnectionStringBuilder.Item[String] Eigenschaft

Definition

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paket:

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

Quelle:

OdbcConnectionStringbuilder.cs

Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest. In C# ist diese Eigenschaft der 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

Parameter

keyword

String

Der Schlüssel des abzurufenden oder festzulegenden Elements.

Eigenschaftswert

Object

Der dem angegebenen Schlüssel zugeordnete Wert.

Ausnahmen

ArgumentException

Die Verbindungszeichenfolge ist falsch formatiert (möglicherweise fehlt das erforderliche "=" innerhalb eines Schlüssel-Wert-Paares).

ArgumentNullException

keyword ist ein NULL-Verweis (Nothing in Visual Basic).

Beispiele

Im folgenden Code wird in einer Konsolenanwendung ein neuer OdbcConnectionStringBuilder erstellt, und der Verbindungszeichenfolge werden mithilfe der Item[]-Eigenschaft Schlüssel-Wert-Paare hinzugefügt.

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

Hinweise

Wenn Sie diese Eigenschaft festlegen, wird der Wert ersetzt, wenn der angegebene Schlüssel bereits im Wörterbuch vorhanden ist. andernfalls wird ein neues Element erstellt.

Weitere Informationen

• Verbindungszeichenfolgen-Generatoren
• Verbindungszeichenfolgen in ADO.NET