Enumerable.ToDictionary Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un Dictionary<TKey,TValue> à partir d’un IEnumerable<T>.
Surcharges
ToDictionary<TKey,TValue>(IEnumerable<ValueTuple<TKey,TValue>>, IEqualityComparer<TKey>)
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
Crée un dictionnaire à partir d’une énumération en fonction du comparateur d’égalité de clé spécifié.
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)Paramètres de type
- TKey
Type des clés des éléments de source.
- TValue
Type des valeurs des éléments de source.
Paramètres
- source
- IEnumerable<ValueTuple<TKey,TValue>>
Énumération à partir de laquelle créer un dictionnaire.
- comparer
- IEqualityComparer<TKey>
Comparateur d’égalité pour comparer les clés.
Retours
Dictionnaire qui contient des clés et des valeurs de source.
Exceptions
source est une référence null.
source contient une ou plusieurs clés en double.
Remarques
Si comparer a la valeur null, le comparateur Default d’égalité par défaut est utilisé pour comparer les clés.
S’applique à
ToDictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>, IEqualityComparer<TKey>)
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
Crée un dictionnaire à partir d’une énumération en fonction du comparateur de clés spécifié.
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)Paramètres de type
- TKey
Type des clés des éléments de source.
- TValue
Type des valeurs des éléments de source.
Paramètres
- source
- IEnumerable<KeyValuePair<TKey,TValue>>
Énumération à partir de laquelle créer un dictionnaire.
- comparer
- IEqualityComparer<TKey>
Comparateur d’égalité pour comparer les clés.
Retours
Dictionnaire qui contient des clés et des valeurs de source.
Exceptions
source est une référence null.
source contient une ou plusieurs clés en double.
Remarques
Si comparer a la valeur null, le comparateur Default d’égalité par défaut est utilisé pour comparer les clés.
S’applique à
ToDictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>)
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
Crée un dictionnaire à partir d’une énumération en fonction du comparateur par défaut pour le type de clé.
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)Paramètres de type
- TKey
Type des clés des éléments de source.
- TValue
Type des valeurs des éléments de source.
Paramètres
- source
- IEnumerable<KeyValuePair<TKey,TValue>>
Énumération à partir de laquelle créer un dictionnaire.
Retours
Dictionnaire qui contient des clés et des valeurs de source et utilise le comparateur par défaut pour le type de clé.
Exceptions
source est une référence null.
source contient une ou plusieurs clés en double.
S’applique à
ToDictionary<TKey,TValue>(IEnumerable<ValueTuple<TKey,TValue>>)
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
Crée un dictionnaire à partir d’une énumération en fonction du comparateur par défaut pour le type de clé.
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)Paramètres de type
- TKey
Type des clés des éléments de source.
- TValue
Type des valeurs des éléments de source.
Paramètres
- source
- IEnumerable<ValueTuple<TKey,TValue>>
Énumération à partir de laquelle créer un dictionnaire.
Retours
Dictionnaire qui contient des clés et des valeurs de source et utilise le comparateur par défaut pour le type de clé.
Exceptions
source est une référence null.
source contient une ou plusieurs clés en double.
S’applique à
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
Crée un Dictionary<TKey,TValue> à partir de IEnumerable<T> selon des fonctions de sélection de clé et de sélection d'élément spécifiées.
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)Paramètres de type
- TSource
Le type des éléments de source.
- TKey
Type de clé retournée par keySelector.
- TElement
Type de la valeur retournée par elementSelector.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> à partir duquel créer un Dictionary<TKey,TValue>.
- keySelector
- Func<TSource,TKey>
Fonction permettant d'extraire une clé de chaque élément.
- elementSelector
- Func<TSource,TElement>
Fonction de transformation permettant de produire une valeur d'élément de résultat à partir de chaque élément.
Retours
Dictionary<TKey,TValue> qui contient des valeurs de type TElement sélectionnées dans la séquence d’entrée.
Exceptions
source ou keySelector ou elementSelector a la valeur null.
- ou -
keySelector produit une clé qui a la valeur null.
keySelector produit des clés en double pour deux éléments.
Remarques
La ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) méthode utilise le comparateur Default d’égalité par défaut pour comparer les clés.
S’applique à
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
Crée un Dictionary<TKey,TValue> à partir de IEnumerable<T> selon une fonction de sélection de clé spécifiée, un comparateur et une fonction de sélection d'élément.
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)Paramètres de type
- TSource
Le type des éléments de source.
- TKey
Type de clé retournée par keySelector.
- TElement
Type de la valeur retournée par elementSelector.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> à partir duquel créer un Dictionary<TKey,TValue>.
- keySelector
- Func<TSource,TKey>
Fonction permettant d'extraire une clé de chaque élément.
- elementSelector
- Func<TSource,TElement>
Fonction de transformation permettant de produire une valeur d'élément de résultat à partir de chaque élément.
- comparer
- IEqualityComparer<TKey>
IEqualityComparer<T> pour comparer les clés.
Retours
Dictionary<TKey,TValue> qui contient des valeurs de type TElement sélectionnées dans la séquence d’entrée.
Exceptions
source ou keySelector ou elementSelector a la valeur null.
- ou -
keySelector produit une clé qui a la valeur null.
keySelector produit des clés en double pour deux éléments.
Remarques
Si comparer a la valeur null, le comparateur Default d’égalité par défaut est utilisé pour comparer les clés.
S’applique à
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
Crée un Dictionary<TKey,TValue> à partir d'un IEnumerable<T> selon une fonction de sélection de clé spécifiée.
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)Paramètres de type
- TSource
Le type des éléments de source.
- TKey
Type de clé retournée par keySelector.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> à partir duquel créer un Dictionary<TKey,TValue>.
- keySelector
- Func<TSource,TKey>
Fonction permettant d'extraire une clé de chaque élément.
Retours
Dictionary<TKey,TValue> qui contient des clés et des valeurs. Les valeurs de chaque groupe apparaissent dans le même ordre que dans source.
Exceptions
source ou keySelector est null.
- ou -
keySelector produit une clé qui a la valeur null.
keySelector produit des clés en double pour deux éléments.
Exemples
L’exemple de code suivant montre comment créer ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) un à l’aide d’un Dictionary<TKey,TValue> sélecteur de clé.
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
Remarques
La ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) méthode utilise le comparateur Default d’égalité par défaut pour comparer les clés.
S’applique à
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
- Source:
- ToCollection.cs
Crée un Dictionary<TKey,TValue> à partir de IEnumerable<T> selon une fonction de sélection de clé spécifiée et un comparateur de clé.
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)Paramètres de type
- TSource
Le type des éléments de source.
- TKey
Type des clés retournées par keySelector.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> à partir duquel créer un Dictionary<TKey,TValue>.
- keySelector
- Func<TSource,TKey>
Fonction permettant d'extraire une clé de chaque élément.
- comparer
- IEqualityComparer<TKey>
IEqualityComparer<T> pour comparer les clés.
Retours
Dictionary<TKey,TValue> qui contient des clés et des valeurs. Les valeurs de chaque groupe apparaissent dans le même ordre que dans source.
Exceptions
source ou keySelector est null.
- ou -
keySelector produit une clé qui a la valeur null.
keySelector produit des clés en double pour deux éléments.
Remarques
Si comparer a la valeur null, le comparateur Default d’égalité par défaut est utilisé pour comparer les clés.
