SqlConnectionStringBuilder.Item[String] Eigenschap

Definitie

Naamruimte:
System.Data.SqlClient
Assembly:
System.Data.dll

Hiermee haalt u de waarde op die is gekoppeld aan de opgegeven sleutel of stelt u deze in. In C# is deze eigenschap de indexeerfunctie.

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

Parameters

keyword
String

De sleutel van het item dat u wilt ophalen of instellen.

Waarde van eigenschap

Object

De waarde die is gekoppeld aan de opgegeven sleutel.

Uitzonderingen

ArgumentNullException

keyword is een null-verwijzing (Nothing in Visual Basic).

KeyNotFoundException

Er is geprobeerd een sleutel toe te voegen die niet bestaat binnen de beschikbare sleutels.

FormatException

Ongeldige waarde binnen de verbindingsreeks (met name een Booleaanse of numerieke waarde is verwacht maar niet opgegeven).

Voorbeelden

Met de volgende code maakt u in een consoletoepassing een nieuwe SqlConnectionStringBuilder en voegt u sleutel-/waardeparen toe aan de bijbehorende verbindingsreeks met behulp van de eigenschap Item[].

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

Opmerkingen

Omdat de SqlConnectionStringBuilder woordenlijst een vaste grootte bevat, probeert u een sleutel toe te voegen die niet in de woordenlijst KeyNotFoundExceptionvoorkomt.

Van toepassing op

Zie ook