DbConnectionStringBuilder.Keys Właściwość

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DbConnectionStringBuilder.cs

Pobiera element ICollection zawierający klucze w elemecie DbConnectionStringBuilder.

public:
 virtual property System::Collections::ICollection ^ Keys { System::Collections::ICollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public virtual System.Collections.ICollection Keys { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Keys : System.Collections.ICollection

Public Overridable ReadOnly Property Keys As ICollection

Wartość właściwości

ICollection

Element ICollection zawierający klucze w elemecie DbConnectionStringBuilder.

Implementuje

Keys

Atrybuty

BrowsableAttribute

Przykłady

Poniższy przykład aplikacji konsolowej tworzy nowy DbConnectionStringBuilderelement i dodaje niektóre klucze. Kod jest zapętlany Keys przez ICollection właściwość wyświetlającą pary klucz/wartość, a następnie dodaje nowy klucz. Keys Ponieważ właściwość zwraca wartość dynamicznąICollection, druga pętla wyświetla wszystkie pary klucz/wartość, w tym najnowszy element.

static void Main()
{
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder["Data Source"] = "(local)";
    builder["Integrated Security"] = true;
    builder["Initial Catalog"] = "AdventureWorks";

    // Obtain reference to the collection of keys.
    ICollection keys = builder.Keys;

    Console.WriteLine("Keys before adding TimeOut:");
    foreach (string key in keys)
        Console.WriteLine("{0}={1}", key, builder[key]);

    // Add a new item to the collection.
    builder["Timeout"] = 300;

    Console.WriteLine();
    Console.WriteLine("Keys after adding TimeOut:");

    // Because the Keys property is dynamically updated,
    // the following loop includes the Timeout key.
    foreach (string key in keys)
        Console.WriteLine("{0}={1}", key, builder[key]);
    Console.WriteLine();
    Console.WriteLine("Press Enter to continue.");
    Console.ReadLine();
}

Sub Main()
    Dim builder As New DbConnectionStringBuilder
    builder("Data Source") = "(local)"
    builder("integrated security") = True
    builder("Initial Catalog") = "AdventureWorks;NewValue=Bad"

    ' Obtain reference to the collection of keys.
    Dim keys As ICollection = builder.Keys

    Console.WriteLine("Keys before adding TimeOut:")
    For Each key As String In keys
        Console.WriteLine("{0}={1}", key, builder(key))
    Next

    ' Add a new item to the collection.
    builder("Timeout") = 300

    Console.WriteLine()
    Console.WriteLine("Keys after adding TimeOut:")

    ' Because the Keys property is dynamically updated, 
    ' the following loop includes the Timeout key.
    For Each key As String In keys
        Console.WriteLine("{0}={1}", key, builder(key))
    Next

    Console.WriteLine()
    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
End Sub

Uwagi

Kolejność wartości w obiekcie ICollection jest nieokreślona, ale jest taka sama jak skojarzona wartość zwrócona ICollection przez Values właściwość.

Zwrócony ICollection element nie jest kopią statyczną. Zamiast tego ICollection odwołuje się do kluczy w oryginalnym DbConnectionStringBuilderobiekcie . W związku z tym zmiany w obiekcie DbConnectionStringBuilder są odzwierciedlane w elemecie ICollection.

Zobacz też

• Parametry połączenia w ADO.NET
• Omówienie ADO.NET