DbConnectionStringBuilder.Keys Propriedade

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbConnectionStringBuilder.cs

Obtém um ICollection que contém as chaves no 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

Valor da propriedade

ICollection

Um ICollection que contém as chaves no DbConnectionStringBuilder.

Implementações

Keys

Atributos

BrowsableAttribute

Exemplos

O exemplo de aplicativo de console a seguir cria um novo DbConnectionStringBuildere adiciona algumas chaves. O código executa um loop pelo ICollection retornado pela Keys propriedade que exibe os pares chave/valor e adiciona uma nova chave. Como a Keys propriedade retorna um dinâmico ICollection, o segundo loop exibe todos os pares chave/valor, incluindo o item mais 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

Comentários

A ordem dos valores no ICollection não é especificada, mas é a mesma ordem que os valores associados no ICollection retornado pela Values propriedade .

O retornado ICollection não é uma cópia estática; em vez disso, o ICollection faz referência às chaves no original DbConnectionStringBuilder. Portanto, as alterações no DbConnectionStringBuilder são refletidas no ICollection.

Confira também

• Cadeias de conexão no ADO.NET
• Visão geral do ADO.NET