DbConnectionStringBuilder.Keys Свойство

Определение

Пространство имен:

System.Data.Common

Сборка:

System.Data.Common.dll

Исходный код:

DbConnectionStringBuilder.cs

Возвращает коллекцию ICollection, которая содержит ключи из 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

Значение свойства

ICollection

Коллекция ICollection, которая содержит ключи из DbConnectionStringBuilder.

Реализации

Keys

Атрибуты

BrowsableAttribute

Примеры

В следующем примере консольного приложения создается новый DbConnectionStringBuilderобъект и добавляются некоторые ключи. Код циклически перебирает объект , ICollection возвращаемый свойством Keys , отображая пары "ключ-значение", а затем добавляет новый ключ. Keys Так как свойство возвращает динамический ICollection, во втором цикле отображаются все пары "ключ-значение", включая новейший элемент.

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

Комментарии

Порядок значений в коллекции ICollection не указан, но он будет точно таким же, как и порядок соответствующих значений в коллекции ICollection, возвращаемой свойством Values.

Возвращаемый ICollection объект не является статической копией; ICollection вместо этого ссылается на ключи в исходном DbConnectionStringBuilderобъекте . Поэтому изменения в DbConnectionStringBuilder отражаются в ICollection.

См. также раздел

• Строки подключения в ADO.NET
• Общие сведения об ADO.NET