SqlConnectionStringBuilder.Item[String] Tulajdonság

Definíció

Névtér:
System.Data.SqlClient
Szerelvény:
System.Data.SqlClient.dll
Szerelvény:
System.Data.dll
Forrás:
System.Data.SqlClient.notsupported.cs

Lekéri vagy beállítja a megadott kulccsal társított értéket. A C#-ban ez a tulajdonság az indexelő.

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

Paraméterek

keyword
String

A lekérni vagy beállítani kívánt elem kulcsa.

Tulajdonság értéke

Object

A megadott kulccsal társított érték.

Kivételek

ArgumentNullException

keyword null értékű hivatkozás (Nothing Visual Basic).

KeyNotFoundException

Olyan kulcsot próbált hozzáadni, amely nem létezik a rendelkezésre álló kulcsok között.

FormatException

Érvénytelen érték a kapcsolati karakterlánc belül (konkrétan logikai vagy numerikus érték várt, de nem lett megadva).

Példák

A következő kód egy konzolalkalmazásban létrehoz egy új SqlConnectionStringBuilder, és hozzáadja a kulcs-érték párokat a kapcsolati karakterlánc a Item[] tulajdonság használatával.

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

Megjegyzések

Mivel a SqlConnectionStringBuilder szótár rögzített méretű szótárat tartalmaz, a szótárban KeyNotFoundExceptionnem létező kulcs hozzáadásakor egy .

A következőre érvényes:

Lásd még