DbConnectionStringBuilder.Keys Proprietà

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

Ottiene un oggetto ICollection che contiene le chiavi presenti in 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

Valore della proprietà

ICollection

Oggetto ICollection che contiene le chiavi presenti in DbConnectionStringBuilder.

Implementazioni

Keys

Attributi

BrowsableAttribute

Esempio

L'esempio di applicazione console seguente crea un nuovo DbConnectionStringBuilderoggetto e aggiunge alcune chiavi. Il codice scorre attraverso la ICollection proprietà restituita Keys dalla proprietà che visualizza le coppie chiave/valore e quindi aggiunge una nuova chiave. Poiché la proprietà restituisce un ciclo dinamicoICollection, il Keys secondo ciclo visualizza tutte le coppie chiave/valore, incluso l'elemento più recente.

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

Commenti

L'ordine dei valori in ICollection non è specificato, ma è lo stesso ordine dei valori associati nell'oggetto ICollection restituito dalla proprietà Values.

Il restituito ICollection non è una copia statica; invece, il ICollection riferimento alle chiavi nell'originale DbConnectionStringBuilder. Pertanto, le modifiche apportate all'oggetto vengono riflesse nell'oggetto DbConnectionStringBuilderICollection.

Vedi anche

• Stringhe di connessione in ADO.NET
• Panoramica di ADO.NET