Dictionary<TKey,TValue>.Keys Propriedade

Referência

Definição

Namespace:: System.Collections.Generic

Assembly:: System.Collections.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: Dictionary.cs

Origem:: Dictionary.cs

Origem:: Dictionary.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém uma coleção que contém as chaves do Dictionary<TKey,TValue>.

public:
 property System::Collections::Generic::Dictionary<TKey, TValue>::KeyCollection ^ Keys { System::Collections::Generic::Dictionary<TKey, TValue>::KeyCollection ^ get(); };

public System.Collections.Generic.Dictionary<TKey,TValue>.KeyCollection Keys { get; }

member this.Keys : System.Collections.Generic.Dictionary<'Key, 'Value>.KeyCollection

Public ReadOnly Property Keys As Dictionary(Of TKey, TValue).KeyCollection

Valor da propriedade

Dictionary<TKey,TValue>.KeyCollection

Um Dictionary<TKey,TValue>.KeyCollection que contém as chaves no Dictionary<TKey,TValue>.

Exemplos

O exemplo de código a seguir mostra como enumerar as chaves no dicionário usando a Keys propriedade e como enumerar as chaves e os valores no dicionário.

Esse código faz parte de um exemplo maior que pode ser compilado e executado (openWith é o nome do Dicionário usado neste exemplo). Consulte Dictionary<TKey,TValue>.

// To get the keys alone, use the Keys property.
Dictionary<String^, String^>::KeyCollection^ keyColl =
    openWith->Keys;

// The elements of the KeyCollection are strongly typed
// with the type that was specified for dictionary keys.
Console::WriteLine();
for each( String^ s in keyColl )
{
    Console::WriteLine("Key = {0}", s);
}

// To get the keys alone, use the Keys property.
Dictionary<string, string>.KeyCollection keyColl =
    openWith.Keys;

// The elements of the KeyCollection are strongly typed
// with the type that was specified for dictionary keys.
Console.WriteLine();
foreach( string s in keyColl )
{
    Console.WriteLine("Key = {0}", s);
}

' To get the keys alone, use the Keys property.
Dim keyColl As _
    Dictionary(Of String, String).KeyCollection = _
    openWith.Keys

' The elements of the KeyCollection are strongly typed
' with the type that was specified for dictionary keys.
Console.WriteLine()
For Each s As String In  keyColl
    Console.WriteLine("Key = {0}", s)
Next s

// When you use foreach to enumerate dictionary elements,
// the elements are retrieved as KeyValuePair objects.
Console::WriteLine();
for each( KeyValuePair<String^, String^> kvp in openWith )
{
    Console::WriteLine("Key = {0}, Value = {1}",
        kvp.Key, kvp.Value);
}

// When you use foreach to enumerate dictionary elements,
// the elements are retrieved as KeyValuePair objects.
Console.WriteLine();
foreach( KeyValuePair<string, string> kvp in openWith )
{
    Console.WriteLine("Key = {0}, Value = {1}",
        kvp.Key, kvp.Value);
}

' When you use foreach to enumerate dictionary elements,
' the elements are retrieved as KeyValuePair objects.
Console.WriteLine()
For Each kvp As KeyValuePair(Of String, String) In openWith
    Console.WriteLine("Key = {0}, Value = {1}", _
        kvp.Key, kvp.Value)
Next kvp

Comentários

A ordem das chaves no Dictionary<TKey,TValue>.KeyCollection não é especificada, mas é a mesma ordem que os valores associados no Dictionary<TKey,TValue>.ValueCollection retornado pela Values propriedade .

O retornado Dictionary<TKey,TValue>.KeyCollection não é uma cópia estática; em vez disso, o Dictionary<TKey,TValue>.KeyCollection faz referência às chaves no original Dictionary<TKey,TValue>. Portanto, as alterações no Dictionary<TKey,TValue> continuam a ser refletidas no Dictionary<TKey,TValue>.KeyCollection.

A obtenção do valor dessa propriedade é uma operação O(1).

Aplica-se a

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Partilhar via