DbConnectionStringBuilder.Keys Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene un oggetto ICollection che contiene le chiavi presenti in DbConnectionStringBuilder.

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

Valore della proprietà

ICollection

Oggetto ICollection che contiene le chiavi presenti in DbConnectionStringBuilder.

Implementazioni

Keys

Attributi: BrowsableAttribute

Esempio

Nell'esempio di applicazione console seguente viene creato un nuovo DbConnectionStringBuilderoggetto e vengono aggiunte alcune chiavi. Il codice scorre l'oggetto ICollection restituito dalla Keys proprietà che visualizza le coppie chiave/valore e quindi aggiunge una nuova chiave. Poiché la Keys proprietà restituisce un oggetto dinamico ICollection, il 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.

L'oggetto restituito ICollection non è una copia statica, ICollection ma fa riferimento alle chiavi nell'oggetto originale DbConnectionStringBuilder. Di conseguenza, le modifiche apportate a DbConnectionStringBuilder vengono riflesse in ICollection.

Si applica a