Enumerable.ToDictionary Método
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.
Cria um Dictionary<TKey,TValue> de um IEnumerable<T>.
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
Cria um dicionário de uma enumeração de acordo com o comparador de igualdade de chave especificado.
public:
generic <typename TKey, typename TValue>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::Dictionary<TKey, TValue> ^ ToDictionary(System::Collections::Generic::IEnumerable<ValueTuple<TKey, TValue>> ^ source, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);public static System.Collections.Generic.Dictionary<TKey,TValue> ToDictionary<TKey,TValue> (this System.Collections.Generic.IEnumerable<(TKey Key, TValue Value)> source, System.Collections.Generic.IEqualityComparer<TKey>? comparer);static member ToDictionary : seq<ValueTuple<'Key, 'Value>> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value><Extension()>
Public Function ToDictionary(Of TKey, TValue) (source As IEnumerable(Of ValueTuple(Of TKey, TValue)), comparer As IEqualityComparer(Of TKey)) As Dictionary(Of TKey, TValue)Parâmetros de tipo
- TKey
O tipo das chaves de elementos de source.
- TValue
O tipo dos valores de elementos de source.
Parâmetros
- source
- IEnumerable<ValueTuple<TKey,TValue>>
A enumeração da qual criar um dicionário.
- comparer
- IEqualityComparer<TKey>
Um comparador de igualdade para comparar chaves.
Retornos
Um dicionário que contém chaves e valores de source.
Exceções
source é uma referência null.
source contém uma ou mais chaves duplicadas.
Comentários
Se comparer for null, o comparador Default de igualdade padrão será usado para comparar chaves.
Aplica-se a
.NET 9 e .NET 8
| Produto | Versões |
|---|---|
| .NET | 8, 9 |
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
Cria um dicionário de uma enumeração de acordo com o comparador de chave especificado.
public:
generic <typename TKey, typename TValue>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::Dictionary<TKey, TValue> ^ ToDictionary(System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ source, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);public static System.Collections.Generic.Dictionary<TKey,TValue> ToDictionary<TKey,TValue> (this System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> source, System.Collections.Generic.IEqualityComparer<TKey>? comparer);static member ToDictionary : seq<System.Collections.Generic.KeyValuePair<'Key, 'Value>> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value><Extension()>
Public Function ToDictionary(Of TKey, TValue) (source As IEnumerable(Of KeyValuePair(Of TKey, TValue)), comparer As IEqualityComparer(Of TKey)) As Dictionary(Of TKey, TValue)Parâmetros de tipo
- TKey
O tipo das chaves de elementos de source.
- TValue
O tipo dos valores de elementos de source.
Parâmetros
- source
- IEnumerable<KeyValuePair<TKey,TValue>>
A enumeração da qual criar um dicionário.
- comparer
- IEqualityComparer<TKey>
Um comparador de igualdade para comparar chaves.
Retornos
Um dicionário que contém chaves e valores de source.
Exceções
source é uma referência null.
source contém uma ou mais chaves duplicadas.
Comentários
Se comparer for null, o comparador Default de igualdade padrão será usado para comparar chaves.
Aplica-se a
.NET 9 e .NET 8
| Produto | Versões |
|---|---|
| .NET | 8, 9 |
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
Cria um dicionário de uma enumeração de acordo com o comparador padrão para o tipo de chave.
public:
generic <typename TKey, typename TValue>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::Dictionary<TKey, TValue> ^ ToDictionary(System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ source);public static System.Collections.Generic.Dictionary<TKey,TValue> ToDictionary<TKey,TValue> (this System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> source);static member ToDictionary : seq<System.Collections.Generic.KeyValuePair<'Key, 'Value>> -> System.Collections.Generic.Dictionary<'Key, 'Value><Extension()>
Public Function ToDictionary(Of TKey, TValue) (source As IEnumerable(Of KeyValuePair(Of TKey, TValue))) As Dictionary(Of TKey, TValue)Parâmetros de tipo
- TKey
O tipo das chaves de elementos de source.
- TValue
O tipo dos valores de elementos de source.
Parâmetros
- source
- IEnumerable<KeyValuePair<TKey,TValue>>
A enumeração da qual criar um dicionário.
Retornos
Um dicionário que contém chaves e valores de source e usa o comparador padrão para o tipo de chave.
Exceções
source é uma referência null.
source contém uma ou mais chaves duplicadas.
Aplica-se a
.NET 9 e .NET 8
| Produto | Versões |
|---|---|
| .NET | 8, 9 |
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
Cria um dicionário de uma enumeração de acordo com o comparador padrão para o tipo de chave.
public:
generic <typename TKey, typename TValue>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::Dictionary<TKey, TValue> ^ ToDictionary(System::Collections::Generic::IEnumerable<ValueTuple<TKey, TValue>> ^ source);public static System.Collections.Generic.Dictionary<TKey,TValue> ToDictionary<TKey,TValue> (this System.Collections.Generic.IEnumerable<(TKey Key, TValue Value)> source);static member ToDictionary : seq<ValueTuple<'Key, 'Value>> -> System.Collections.Generic.Dictionary<'Key, 'Value><Extension()>
Public Function ToDictionary(Of TKey, TValue) (source As IEnumerable(Of ValueTuple(Of TKey, TValue))) As Dictionary(Of TKey, TValue)Parâmetros de tipo
- TKey
O tipo das chaves de elementos de source.
- TValue
O tipo dos valores de elementos de source.
Parâmetros
- source
- IEnumerable<ValueTuple<TKey,TValue>>
A enumeração da qual criar um dicionário.
Retornos
Um dicionário que contém chaves e valores de source e usa o comparador padrão para o tipo de chave.
Exceções
source é uma referência null.
source contém uma ou mais chaves duplicadas.
Aplica-se a
.NET 9 e .NET 8
| Produto | Versões |
|---|---|
| .NET | 8, 9 |
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
Cria um Dictionary<TKey,TValue> de um IEnumerable<T>, de acordo com as funções especificadas de seletor de chave e seletor de elemento.
public:
generic <typename TSource, typename TKey, typename TElement>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::Dictionary<TKey, TElement> ^ ToDictionary(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, Func<TSource, TElement> ^ elementSelector);public static System.Collections.Generic.Dictionary<TKey,TElement> ToDictionary<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector);static member ToDictionary : seq<'Source> * Func<'Source, 'Key> * Func<'Source, 'Element> -> System.Collections.Generic.Dictionary<'Key, 'Element><Extension()>
Public Function ToDictionary(Of TSource, TKey, TElement) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), elementSelector As Func(Of TSource, TElement)) As Dictionary(Of TKey, TElement)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
- TKey
O tipo da chave retornada por keySelector.
- TElement
O tipo do valor retornado por elementSelector.
Parâmetros
- source
- IEnumerable<TSource>
Um IEnumerable<T> por meio do qual um Dictionary<TKey,TValue> será criado.
- keySelector
- Func<TSource,TKey>
Uma função para extrair uma chave de cada elemento.
- elementSelector
- Func<TSource,TElement>
Uma função de transformação para produzir um valor de elemento de resultado de cada elemento.
Retornos
Um Dictionary<TKey,TValue> que contém valores do tipo TElement selecionados da sequência de entrada.
Exceções
source, keySelector ou elementSelector é null.
- ou -
keySelector gera uma chave que é null.
keySelector gera chaves duplicatas para dois elementos.
Comentários
O ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) método usa o comparador Default de igualdade padrão para comparar chaves.
Aplica-se a
.NET 9 e outras versões
| 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 | 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 |
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
Cria um Dictionary<TKey,TValue> de um IEnumerable<T> de acordo com uma função de seletor de chave, um comparador e uma função de seletor de elemento especificados.
public:
generic <typename TSource, typename TKey, typename TElement>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::Dictionary<TKey, TElement> ^ ToDictionary(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, Func<TSource, TElement> ^ elementSelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);public static System.Collections.Generic.Dictionary<TKey,TElement> ToDictionary<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);public static System.Collections.Generic.Dictionary<TKey,TElement> ToDictionary<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);static member ToDictionary : seq<'Source> * Func<'Source, 'Key> * Func<'Source, 'Element> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Element><Extension()>
Public Function ToDictionary(Of TSource, TKey, TElement) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), elementSelector As Func(Of TSource, TElement), comparer As IEqualityComparer(Of TKey)) As Dictionary(Of TKey, TElement)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
- TKey
O tipo da chave retornada por keySelector.
- TElement
O tipo do valor retornado por elementSelector.
Parâmetros
- source
- IEnumerable<TSource>
Um IEnumerable<T> por meio do qual um Dictionary<TKey,TValue> será criado.
- keySelector
- Func<TSource,TKey>
Uma função para extrair uma chave de cada elemento.
- elementSelector
- Func<TSource,TElement>
Uma função de transformação para produzir um valor de elemento de resultado de cada elemento.
- comparer
- IEqualityComparer<TKey>
Um IEqualityComparer<T> para comparar chaves.
Retornos
Um Dictionary<TKey,TValue> que contém valores do tipo TElement selecionados da sequência de entrada.
Exceções
source, keySelector ou elementSelector é null.
- ou -
keySelector gera uma chave que é null.
keySelector gera chaves duplicatas para dois elementos.
Comentários
Se comparer for null, o comparador Default de igualdade padrão será usado para comparar chaves.
Aplica-se a
.NET 9 e outras versões
| 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 | 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 |
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
Cria um Dictionary<TKey,TValue> de um IEnumerable<T>, de acordo com uma função de seletor de chave especificada.
public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::Dictionary<TKey, TSource> ^ ToDictionary(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector);public static System.Collections.Generic.Dictionary<TKey,TSource> ToDictionary<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);static member ToDictionary : seq<'Source> * Func<'Source, 'Key> -> System.Collections.Generic.Dictionary<'Key, 'Source><Extension()>
Public Function ToDictionary(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As Dictionary(Of TKey, TSource)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
- TKey
O tipo da chave retornada por keySelector.
Parâmetros
- source
- IEnumerable<TSource>
Um IEnumerable<T> por meio do qual um Dictionary<TKey,TValue> será criado.
- keySelector
- Func<TSource,TKey>
Uma função para extrair uma chave de cada elemento.
Retornos
Um Dictionary<TKey,TValue> que contém chaves e valores. Os valores dentro de cada grupo estão na mesma ordem que no source.
Exceções
keySelector gera chaves duplicatas para dois elementos.
Exemplos
O exemplo de código a seguir demonstra como usar ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) para criar um Dictionary<TKey,TValue> usando um seletor de chave.
class Package
{
public string Company { get; set; }
public double Weight { get; set; }
public long TrackingNumber { get; set; }
}
public static void ToDictionaryEx1()
{
List<Package> packages =
new List<Package>
{ new Package { Company = "Coho Vineyard", Weight = 25.2, TrackingNumber = 89453312L },
new Package { Company = "Lucerne Publishing", Weight = 18.7, TrackingNumber = 89112755L },
new Package { Company = "Wingtip Toys", Weight = 6.0, TrackingNumber = 299456122L },
new Package { Company = "Adventure Works", Weight = 33.8, TrackingNumber = 4665518773L } };
// Create a Dictionary of Package objects,
// using TrackingNumber as the key.
Dictionary<long, Package> dictionary =
packages.ToDictionary(p => p.TrackingNumber);
foreach (KeyValuePair<long, Package> kvp in dictionary)
{
Console.WriteLine(
"Key {0}: {1}, {2} pounds",
kvp.Key,
kvp.Value.Company,
kvp.Value.Weight);
}
}
/*
This code produces the following output:
Key 89453312: Coho Vineyard, 25.2 pounds
Key 89112755: Lucerne Publishing, 18.7 pounds
Key 299456122: Wingtip Toys, 6 pounds
Key 4665518773: Adventure Works, 33.8 pounds
*/
Structure Package
Public Company As String
Public Weight As Double
Public TrackingNumber As Long
End Structure
Sub ToDictionaryEx1()
' Create a list of Package values.
Dim packages As New List(Of Package)(New Package() _
{New Package With
{.Company = "Coho Vineyard", .Weight = 25.2, .TrackingNumber = 89453312L},
New Package With
{.Company = "Lucerne Publishing", .Weight = 18.7, .TrackingNumber = 89112755L},
New Package With
{.Company = "Wingtip Toys", .Weight = 6.0, .TrackingNumber = 299456122L},
New Package With
{.Company = "Adventure Works", .Weight = 33.8, .TrackingNumber = 4665518773L}})
' Create a Dictionary that contains Package values,
' using TrackingNumber as the key.
Dim dict As Dictionary(Of Long, Package) =
packages.ToDictionary(Function(p) p.TrackingNumber)
' Display the results.
Dim output As New System.Text.StringBuilder
For Each kvp As KeyValuePair(Of Long, Package) In dict
output.AppendLine("Key " & kvp.Key & ": " &
kvp.Value.Company & ", " &
kvp.Value.Weight & " pounds")
Next
Console.WriteLine(output.ToString())
End Sub
' This code produces the following output:
'
' Key 89453312: Coho Vineyard, 25.2 pounds
' Key 89112755: Lucerne Publishing, 18.7 pounds
' Key 299456122: Wingtip Toys, 6 pounds
' Key 4665518773: Adventure Works, 33.8 pounds
Comentários
O ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) método usa o comparador Default de igualdade padrão para comparar chaves.
Aplica-se a
.NET 9 e outras versões
| 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 | 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 |
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
- Origem:
- ToCollection.cs
Cria um Dictionary<TKey,TValue> de um IEnumerable<T>, de acordo com uma função de seletor de chave especificada e um comparador de chaves.
public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::Dictionary<TKey, TSource> ^ ToDictionary(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);public static System.Collections.Generic.Dictionary<TKey,TSource> ToDictionary<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);public static System.Collections.Generic.Dictionary<TKey,TSource> ToDictionary<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);static member ToDictionary : seq<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Source><Extension()>
Public Function ToDictionary(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IEqualityComparer(Of TKey)) As Dictionary(Of TKey, TSource)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
- TKey
O tipo das chaves retornadas por keySelector.
Parâmetros
- source
- IEnumerable<TSource>
Um IEnumerable<T> por meio do qual um Dictionary<TKey,TValue> será criado.
- keySelector
- Func<TSource,TKey>
Uma função para extrair uma chave de cada elemento.
- comparer
- IEqualityComparer<TKey>
Um IEqualityComparer<T> para comparar chaves.
Retornos
Um Dictionary<TKey,TValue> que contém chaves e valores. Os valores dentro de cada grupo estão na mesma ordem que no source.
Exceções
keySelector gera chaves duplicatas para dois elementos.
Comentários
Se comparer for null, o comparador Default de igualdade padrão será usado para comparar chaves.
Aplica-se a
.NET 9 e outras versões
| 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 | 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 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: