DbConnectionStringBuilder.Keys Eigenschaft

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

public virtual System.Collections.ICollection Keys { get; }

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

member this.Keys : System.Collections.ICollection

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

Public Overridable ReadOnly Property Keys As ICollection

Eigenschaftswert

Eine ICollection, die die Schlüssel im DbConnectionStringBuilder enthält.

Implementiert

Attribute

BrowsableAttribute

Beispiele

Im folgenden Konsolenanwendungsbeispiel wird ein neuer DbConnectionStringBuildererstellt und einige Schlüssel hinzugefügt. Der Code durchläuft die von der ICollectionKeys Eigenschaft zurückgegebene, die die Schlüssel-Wert-Paare anzeigt, und fügt dann einen neuen Schlüssel hinzu. Da die Keys Eigenschaft eine dynamische ICollectionzurückgibt, zeigt die zweite Schleife alle Schlüssel-Wert-Paare an, einschließlich des neuesten Elements.

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

Hinweise

Die Reihenfolge der Werte in der ICollection ist nicht vorgegeben, doch es handelt sich um die gleiche Reihenfolge, die auch bei den zugehörigen Werten in der ICollection verwendet wird, die von der der Values-Eigenschaft zurückgegeben wird.

Das zurückgegebene ICollection ist keine statische Kopie, ICollection sondern verweist auf die Schlüssel im ursprünglichen DbConnectionStringBuilder. Daher werden Änderungen an der DbConnectionStringBuilder im widerspiegelt ICollection.

Gilt für:

Weitere Informationen

• Verbindungszeichenfolgen in ADO.NET
• Übersicht über ADO.NET