Sdílet prostřednictvím

Enumerable.ToDictionary Metoda

  • Reference

Definice

Obor názvů:
System.Linq
Sestavení:
System.Linq.dll
Sestavení:
System.Core.dll
Sestavení:
netstandard.dll

Vytvoří z Dictionary<TKey,TValue> objektu IEnumerable<T>.

Přetížení

ToDictionary<TKey,TValue>(IEnumerable<ValueTuple<TKey,TValue>>, IEqualityComparer<TKey>)

Vytvoří slovník z výčtu podle zadaného porovnávače rovnosti klíčů.
ToDictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>, IEqualityComparer<TKey>)

Vytvoří slovník z výčtu podle zadaného porovnávače klíčů.
ToDictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>)

Vytvoří slovník z výčtu podle výchozího porovnávače pro typ klíče.
ToDictionary<TKey,TValue>(IEnumerable<ValueTuple<TKey,TValue>>)

Vytvoří slovník z výčtu podle výchozího porovnávače pro typ klíče.
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)

Dictionary<TKey,TValue> Vytvoří z objektu IEnumerable<T> podle zadaného selektoru klíčů a funkcí selektoru prvků.
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)

Dictionary<TKey,TValue> Vytvoří z objektu IEnumerable<T> podle zadané funkce selektoru klíčů, porovnávače a funkce selektoru prvků.
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

Dictionary<TKey,TValue> Vytvoří z objektu IEnumerable<T> podle zadané funkce selektoru klíčů.
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

Dictionary<TKey,TValue> Vytvoří z objektu IEnumerable<T> podle zadané funkce selektoru klíčů a porovnávače klíčů.

ToDictionary<TKey,TValue>(IEnumerable<ValueTuple<TKey,TValue>>, IEqualityComparer<TKey>)

Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs

Vytvoří slovník z výčtu podle zadaného porovnávače rovnosti klíčů.

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)

Parametry typu

TKey

Typ klíčů z elementů .source

TValue

Typ hodnot z prvků .source

Parametry

source
IEnumerable<ValueTuple<TKey,TValue>>

Výčet pro vytvoření slovníku z.

comparer
IEqualityComparer<TKey>

Porovnávače rovnosti pro porovnávání klíčů.

Návraty

Dictionary<TKey,TValue>

Slovník, který obsahuje klíče a hodnoty z source.

Výjimky

ArgumentNullException

source je odkaz null .

ArgumentException

source obsahuje jeden nebo více duplicitních klíčů.

Poznámky

Pokud comparer je null, použije se k porovnání klíčů výchozí porovnávače Default rovnosti.

Platí pro

ToDictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>, IEqualityComparer<TKey>)

Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs

Vytvoří slovník z výčtu podle zadaného porovnávače klíčů.

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)

Parametry typu

TKey

Typ klíčů z elementů .source

TValue

Typ hodnot z prvků .source

Parametry

source
IEnumerable<KeyValuePair<TKey,TValue>>

Výčet pro vytvoření slovníku z.

comparer
IEqualityComparer<TKey>

Porovnávače rovnosti pro porovnávání klíčů.

Návraty

Dictionary<TKey,TValue>

Slovník, který obsahuje klíče a hodnoty z source.

Výjimky

ArgumentNullException

source je odkaz null .

ArgumentException

source obsahuje jeden nebo více duplicitních klíčů.

Poznámky

Pokud comparer je null, použije se k porovnání klíčů výchozí porovnávače Default rovnosti.

Platí pro

ToDictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>)

Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs

Vytvoří slovník z výčtu podle výchozího porovnávače pro typ klíče.

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)

Parametry typu

TKey

Typ klíčů z elementů .source

TValue

Typ hodnot z prvků .source

Parametry

source
IEnumerable<KeyValuePair<TKey,TValue>>

Výčet pro vytvoření slovníku z.

Návraty

Dictionary<TKey,TValue>

Slovník, který obsahuje klíče a hodnoty z source a používá výchozí porovnávací nástroj pro typ klíče.

Výjimky

ArgumentNullException

source je odkaz null .

ArgumentException

source obsahuje jeden nebo více duplicitních klíčů.

Platí pro

ToDictionary<TKey,TValue>(IEnumerable<ValueTuple<TKey,TValue>>)

Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs

Vytvoří slovník z výčtu podle výchozího porovnávače pro typ klíče.

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)

Parametry typu

TKey

Typ klíčů z elementů .source

TValue

Typ hodnot z prvků .source

Parametry

source
IEnumerable<ValueTuple<TKey,TValue>>

Výčet pro vytvoření slovníku z.

Návraty

Dictionary<TKey,TValue>

Slovník, který obsahuje klíče a hodnoty z source a používá výchozí porovnávací nástroj pro typ klíče.

Výjimky

ArgumentNullException

source je odkaz null .

ArgumentException

source obsahuje jeden nebo více duplicitních klíčů.

Platí pro

ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)

Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs

Dictionary<TKey,TValue> Vytvoří z objektu IEnumerable<T> podle zadaného selektoru klíčů a funkcí selektoru prvků.

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)

Parametry typu

TSource

Typ prvků objektu source.

TKey

Typ klíče vráceného nástrojem keySelector.

TElement

Typ hodnoty vrácené parametrem elementSelector.

Parametry

source
IEnumerable<TSource>

Chcete-li IEnumerable<T>Dictionary<TKey,TValue> vytvořit z.

keySelector
Func<TSource,TKey>

Funkce, která extrahuje klíč z každého prvku.

elementSelector
Func<TSource,TElement>

Transformační funkce, která z každého prvku vytvoří hodnotu výsledného prvku.

Návraty

Dictionary<TKey,TElement>

A Dictionary<TKey,TValue> obsahující hodnoty typu TElement vybraného ze vstupní sekvence.

Výjimky

ArgumentNullException

source nebo keySelectorelementSelector je null.

-nebo-

keySelector vytvoří klíč , který je null.

ArgumentException

keySelector vytvoří duplicitní klíče pro dva prvky.

Poznámky

Metoda ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) používá k porovnání klíčů výchozí porovnávače Default rovnosti.

Platí pro

ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)

Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs

Dictionary<TKey,TValue> Vytvoří z objektu IEnumerable<T> podle zadané funkce selektoru klíčů, porovnávače a funkce selektoru prvků.

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)

Parametry typu

TSource

Typ prvků objektu source.

TKey

Typ klíče vráceného nástrojem keySelector.

TElement

Typ hodnoty vrácené parametrem elementSelector.

Parametry

source
IEnumerable<TSource>

Chcete-li IEnumerable<T>Dictionary<TKey,TValue> vytvořit z.

keySelector
Func<TSource,TKey>

Funkce, která extrahuje klíč z každého prvku.

elementSelector
Func<TSource,TElement>

Transformační funkce, která z každého prvku vytvoří hodnotu výsledného prvku.

comparer
IEqualityComparer<TKey>

K IEqualityComparer<T> porovnání klíčů.

Návraty

Dictionary<TKey,TElement>

A Dictionary<TKey,TValue> obsahující hodnoty typu TElement vybraného ze vstupní sekvence.

Výjimky

ArgumentNullException

source nebo keySelectorelementSelector je null.

-nebo-

keySelector vytvoří klíč , který je null.

ArgumentException

keySelector vytvoří duplicitní klíče pro dva prvky.

Poznámky

Pokud comparer je null, použije se k porovnání klíčů výchozí porovnávače Default rovnosti.

Platí pro

ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs

Dictionary<TKey,TValue> Vytvoří z objektu IEnumerable<T> podle zadané funkce selektoru klíčů.

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)

Parametry typu

TSource

Typ prvků objektu source.

TKey

Typ klíče vráceného nástrojem keySelector.

Parametry

source
IEnumerable<TSource>

Chcete-li IEnumerable<T>Dictionary<TKey,TValue> vytvořit z.

keySelector
Func<TSource,TKey>

Funkce, která extrahuje klíč z každého prvku.

Návraty

Dictionary<TKey,TSource>

A Dictionary<TKey,TValue> , který obsahuje klíče a hodnoty. Hodnoty v každé skupině jsou ve stejném pořadí jako v source.

Výjimky

ArgumentNullException

source nebo keySelector je null.

-nebo-

keySelector vytvoří klíč , který je null.

ArgumentException

keySelector vytvoří duplicitní klíče pro dva prvky.

Příklady

Následující příklad kódu ukazuje, jak použít ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) k vytvoření Dictionary<TKey,TValue> pomocí selektoru klíčů.

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

Poznámky

Metoda ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) používá k porovnání klíčů výchozí porovnávače Default rovnosti.

Platí pro

ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs
Zdroj:
ToCollection.cs

Dictionary<TKey,TValue> Vytvoří z objektu IEnumerable<T> podle zadané funkce selektoru klíčů a porovnávače klíčů.

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)

Parametry typu

TSource

Typ prvků objektu source.

TKey

Typ klíčů vrácených nástrojem keySelector.

Parametry

source
IEnumerable<TSource>

Chcete-li IEnumerable<T>Dictionary<TKey,TValue> vytvořit z.

keySelector
Func<TSource,TKey>

Funkce, která extrahuje klíč z každého prvku.

comparer
IEqualityComparer<TKey>

K IEqualityComparer<T> porovnání klíčů.

Návraty

Dictionary<TKey,TSource>

A Dictionary<TKey,TValue> , který obsahuje klíče a hodnoty. Hodnoty v každé skupině jsou ve stejném pořadí jako v source.

Výjimky

ArgumentNullException

source nebo keySelector je null.

-nebo-

keySelector vytvoří klíč , který je null.

ArgumentException

keySelector vytvoří duplicitní klíče pro dva prvky.

Poznámky

Pokud comparer je null, použije se k porovnání klíčů výchozí porovnávače Default rovnosti.

Platí pro