SqlConnectionStringBuilder.Item[String] Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.SqlClient

Zestaw:: System.Data.SqlClient.dll

Zestaw:: System.Data.dll

Zestawy:: netstandard.dll, System.Data.SqlClient.dll

Pakiet:: System.Data.SqlClient v4.8.6

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wartość skojarzona z określonym kluczem. W języku C#ta właściwość jest indeksatorem.

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

Parametry

keyword: String

Klucz elementu do pobrania lub ustawienia.

Wartość właściwości

Object

Wartość skojarzona z określonym kluczem.

Wyjątki

ArgumentNullException

keyword jest odwołaniem o wartości null (Nothing w Visual Basic).

KeyNotFoundException

Podjęto próbę dodania klucza, który nie istnieje w dostępnych kluczach.

FormatException

Nieprawidłowa wartość w parametry połączenia (w szczególności oczekiwano wartości logicznej lub liczbowej, ale nie podano).

Przykłady

Poniższy kod w aplikacji konsolowej tworzy nową parę SqlConnectionStringBuilder klucz/wartość do jej parametry połączenia przy użyciu Item[] właściwości .

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

Uwagi

Ponieważ element SqlConnectionStringBuilder zawiera słownik o stałym rozmiarze, próbuje dodać klucz, który nie istnieje w słowniku, zgłasza błąd KeyNotFoundException.

Dotyczy

Share via