Enumerable.ToDictionary Metoda

Reference

Definice

Obor názvů:: System.Linq

Sestavení:: System.Linq.dll

Sestavení:: System.Core.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Přetížení

ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	Dictionary<TKey,TValue> Vytvoří ze zadaného selektoru IEnumerable<T> klíče a funkce selektoru prvků.
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Dictionary<TKey,TValue> Vytvoří ze IEnumerable<T> zadané funkce selektoru klíčů, porovnávače a funkce selektoru prvků.
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Dictionary<TKey,TValue> Vytvoří ze zadané funkce selektoru klíčů z IEnumerable<T> závislosti na zadané funkci selektoru klíčů.
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Dictionary<TKey,TValue> Vytvoří ze zadané funkce selektoru klíčů a porovnávače klíčů z IEnumerable<T> závislosti na zadané funkci selektoru klíčů.

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

Dictionary<TKey,TValue> Vytvoří ze zadaného selektoru IEnumerable<T> klíč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);

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ů source.

TKey

Typ klíče vráceného řetězcem keySelector.

TElement

Typ hodnoty vrácené hodnotou elementSelector.

Parametry

source: IEnumerable<TSource>

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

keySelector: Func<TSource,TKey>

Funkce pro extrahování klíče z každého prvku

elementSelector: Func<TSource,TElement>

Transformační funkce pro vytvoření hodnoty prvku výsledku z každého prvku.

Návraty

Dictionary<TKey,TElement>

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

Výjimky

ArgumentNullException

source nebo keySelector elementSelector 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č Default rovnosti.

Platí pro

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

Dictionary<TKey,TValue> Vytvoří ze IEnumerable<T> 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ů source.

TKey

Typ klíče vráceného řetězcem keySelector.

TElement

Typ hodnoty vrácené hodnotou elementSelector.

Parametry

source: IEnumerable<TSource>

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

keySelector: Func<TSource,TKey>

Funkce pro extrahování klíče z každého prvku

elementSelector: Func<TSource,TElement>

Transformační funkce pro vytvoření hodnoty prvku výsledku z každé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é ze vstupní sekvence.

Výjimky

ArgumentNullException

source nebo keySelector elementSelector je null.

-nebo-

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

ArgumentException

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

Poznámky

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

Platí pro

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

Dictionary<TKey,TValue> Vytvoří ze zadané funkce selektoru klíčů z IEnumerable<T> závislosti na zadané funkci 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ů .source

TKey

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

Parametry

source: IEnumerable<TSource>

An IEnumerable<T> to create a Dictionary<TKey,TValue> from.

keySelector: Func<TSource,TKey>

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

Návraty

Dictionary<TKey,TSource>

A Dictionary<TKey,TValue> obsahující klíče a hodnoty. Hodnoty v rámci každé skupiny 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č Default rovnosti.

Platí pro

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

Dictionary<TKey,TValue> Vytvoří ze zadané funkce selektoru klíčů a porovnávače klíčů z IEnumerable<T> závislosti na zadané funkci 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, 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ů .source

TKey

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

Parametry

source: IEnumerable<TSource>

An IEnumerable<T> to create a Dictionary<TKey,TValue> from.

keySelector: Func<TSource,TKey>

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

comparer: IEqualityComparer<TKey>

Porovnávání IEqualityComparer<T> klíčů.

Návraty

Dictionary<TKey,TSource>

A Dictionary<TKey,TValue> obsahující klíče a hodnoty. Hodnoty v rámci každé skupiny 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 ano null, použije se k porovnání klíčů výchozí porovnávač Default rovnosti.

Platí pro

Enumerable.ToDictionary Metoda

Definice

Přetížení

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

Parametry typu

Parametry

Návraty

Výjimky

Poznámky

Platí pro

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

Parametry typu

Parametry

Návraty

Výjimky

Poznámky

Platí pro

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

Parametry typu

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

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

Parametry typu

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Další materiály