SqlConnectionStringBuilder.Item[String] Eigenschaft

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Quelle:
System.Data.SqlClient.notsupported.cs

Dient zum Abrufen oder Festlegen des Werts, der dem angegebenen Schlüssel zugeordnet ist. 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 Elements, das abgerufen oder festgelegt werden soll.

Eigenschaftswert

Object

Der dem angegebenen Schlüssel zugeordnete Wert.

Ausnahmen

ArgumentNullException

keyword ist ein Nullverweis (Nothing in Visual Basic).

KeyNotFoundException

Es wurde versucht, einen Schlüssel hinzuzufügen, der nicht in den verfügbaren Schlüsseln vorhanden ist.

FormatException

Ungültiger Wert innerhalb der Verbindungszeichenfolge (insbesondere ein boolescher oder numerischer Wert wurde erwartet, aber nicht angegeben).

Beispiele

Der folgende Code in einer Konsolenanwendung erstellt eine neue SqlConnectionStringBuilder und fügt schlüssel/wert-Paare zu seinen Verbindungszeichenfolge hinzu, wobei die Eigenschaft Item[] verwendet wird.

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

Hinweise

Da das SqlConnectionStringBuilder Wörterbuch ein Wörterbuch mit fester Größe enthält, wird versucht, einen Schlüssel hinzuzufügen, der nicht im Wörterbuch KeyNotFoundExceptionvorhanden ist.

Gilt für:

Weitere Informationen