Auf Englisch lesen

Freigeben über


Enumerable.ToDictionary Methode

Definition

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T>.

Überlädt

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

Erstellt ein Wörterbuch aus einer Enumeration gemäß dem angegebenen Schlüsselgleichheitsvergleich.

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

Erstellt ein Wörterbuch aus einer Enumeration gemäß dem angegebenen Schlüsselvergleich.

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

Erstellt ein Wörterbuch aus einer Enumeration gemäß dem Standardvergleich für den Schlüsseltyp.

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

Erstellt ein Wörterbuch aus einer Enumeration gemäß dem Standardvergleich für den Schlüsseltyp.

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

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T> entsprechend der angegebenen Schlüsselauswahlfunktion und Elementauswahlfunktion

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

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T> entsprechend einer angegebenen Schlüsselauswahlfunktion, einem Vergleich und einer Elementauswahlfunktion

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

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T> gemäß einer angegebenen Schlüsselauswahlfunktion

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

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T> gemäß einer angegebenen Schlüsselauswahlfunktion und eines angegebenen Schlüsselvergleichs

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

Quelle:
ToCollection.cs
Quelle:
ToCollection.cs

Erstellt ein Wörterbuch aus einer Enumeration gemäß dem angegebenen Schlüsselgleichheitsvergleich.

C#
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);

Typparameter

TKey

Der Typ der Schlüssel aus Elementen von source.

TValue

Der Typ der Werte aus Elementen von source.

Parameter

source
IEnumerable<ValueTuple<TKey,TValue>>

Die Enumeration, aus der ein Wörterbuch erstellt werden soll.

comparer
IEqualityComparer<TKey>

Ein Gleichheitsvergleich zum Vergleichen von Schlüsseln.

Gibt zurück

Ein Wörterbuch, das Schlüssel und Werte aus sourceenthält.

Ausnahmen

source ist ein null-Verweis.

source enthält mindestens einen doppelten Schlüssel.

Hinweise

Wenn comparer ist null, wird der Standardmäßige Gleichheitsvergleich Default zum Vergleichen von Schlüsseln verwendet.

Gilt für:

.NET 9 und .NET 8
Produkt Versionen
.NET 8, 9

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

Quelle:
ToCollection.cs
Quelle:
ToCollection.cs

Erstellt ein Wörterbuch aus einer Enumeration gemäß dem angegebenen Schlüsselvergleich.

C#
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);

Typparameter

TKey

Der Typ der Schlüssel aus Elementen von source.

TValue

Der Typ der Werte aus Elementen von source.

Parameter

source
IEnumerable<KeyValuePair<TKey,TValue>>

Die Enumeration, aus der ein Wörterbuch erstellt werden soll.

comparer
IEqualityComparer<TKey>

Ein Gleichheitsvergleich zum Vergleichen von Schlüsseln.

Gibt zurück

Ein Wörterbuch, das Schlüssel und Werte aus sourceenthält.

Ausnahmen

source ist ein null-Verweis.

source enthält mindestens einen doppelten Schlüssel.

Hinweise

Wenn comparer ist null, wird der Standardmäßige Gleichheitsvergleich Default zum Vergleichen von Schlüsseln verwendet.

Gilt für:

.NET 9 und .NET 8
Produkt Versionen
.NET 8, 9

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

Quelle:
ToCollection.cs
Quelle:
ToCollection.cs

Erstellt ein Wörterbuch aus einer Enumeration gemäß dem Standardvergleich für den Schlüsseltyp.

C#
public static System.Collections.Generic.Dictionary<TKey,TValue> ToDictionary<TKey,TValue> (this System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> source);

Typparameter

TKey

Der Typ der Schlüssel aus Elementen von source.

TValue

Der Typ der Werte aus Elementen von source.

Parameter

source
IEnumerable<KeyValuePair<TKey,TValue>>

Die Enumeration, aus der ein Wörterbuch erstellt werden soll.

Gibt zurück

Ein Wörterbuch, das Schlüssel und Werte von source enthält und den Standardvergleich für den Schlüsseltyp verwendet.

Ausnahmen

source ist ein null-Verweis.

source enthält mindestens einen doppelten Schlüssel.

Gilt für:

.NET 9 und .NET 8
Produkt Versionen
.NET 8, 9

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

Quelle:
ToCollection.cs
Quelle:
ToCollection.cs

Erstellt ein Wörterbuch aus einer Enumeration gemäß dem Standardvergleich für den Schlüsseltyp.

C#
public static System.Collections.Generic.Dictionary<TKey,TValue> ToDictionary<TKey,TValue> (this System.Collections.Generic.IEnumerable<(TKey Key, TValue Value)> source);

Typparameter

TKey

Der Typ der Schlüssel aus Elementen von source.

TValue

Der Typ der Werte aus Elementen von source.

Parameter

source
IEnumerable<ValueTuple<TKey,TValue>>

Die Enumeration, aus der ein Wörterbuch erstellt werden soll.

Gibt zurück

Ein Wörterbuch, das Schlüssel und Werte von source enthält und den Standardvergleich für den Schlüsseltyp verwendet.

Ausnahmen

source ist ein null-Verweis.

source enthält mindestens einen doppelten Schlüssel.

Gilt für:

.NET 9 und .NET 8
Produkt Versionen
.NET 8, 9

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

Quelle:
ToCollection.cs
Quelle:
ToCollection.cs
Quelle:
ToCollection.cs

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T> entsprechend der angegebenen Schlüsselauswahlfunktion und Elementauswahlfunktion

C#
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);

Typparameter

TSource

Der Typ der Elemente von source.

TKey

Der Typ des von keySelector zurückgegebenen Schlüssels.

TElement

Der Typ des von elementSelector zurückgegebenen Werts.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein Dictionary<TKey,TValue> erstellt werden soll

keySelector
Func<TSource,TKey>

Eine Funktion zum Extrahieren eines Schlüssels aus jedem Element.

elementSelector
Func<TSource,TElement>

Eine Transformationsfunktion, mit der aus jedem Element ein Ergebniselementwert erzeugt wird.

Gibt zurück

Dictionary<TKey,TElement>

Ein Dictionary<TKey,TValue>, das Werte vom Typ TElement enthält, die aus der Eingabesequenz ausgewählt werden.

Ausnahmen

source oder keySelector oder elementSelector ist null.

- oder -

keySelector erzeugt einen Schlüssel, der null ist.

keySelector erzeugt für zwei Elemente doppelte Schlüssel.

Hinweise

Die ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) -Methode verwendet den Standardgleichvergleich Default , um Schlüssel zu vergleichen.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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>)

Quelle:
ToCollection.cs
Quelle:
ToCollection.cs
Quelle:
ToCollection.cs

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T> entsprechend einer angegebenen Schlüsselauswahlfunktion, einem Vergleich und einer Elementauswahlfunktion

C#
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);
C#
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);

Typparameter

TSource

Der Typ der Elemente von source.

TKey

Der Typ des von keySelector zurückgegebenen Schlüssels.

TElement

Der Typ des von elementSelector zurückgegebenen Werts.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein Dictionary<TKey,TValue> erstellt werden soll

keySelector
Func<TSource,TKey>

Eine Funktion zum Extrahieren eines Schlüssels aus jedem Element.

elementSelector
Func<TSource,TElement>

Eine Transformationsfunktion, mit der aus jedem Element ein Ergebniselementwert erzeugt wird.

comparer
IEqualityComparer<TKey>

Ein IEqualityComparer<T> zum Vergleichen von Schlüsseln.

Gibt zurück

Dictionary<TKey,TElement>

Ein Dictionary<TKey,TValue>, das Werte vom Typ TElement enthält, die aus der Eingabesequenz ausgewählt werden.

Ausnahmen

source oder keySelector oder elementSelector ist null.

- oder -

keySelector erzeugt einen Schlüssel, der null ist.

keySelector erzeugt für zwei Elemente doppelte Schlüssel.

Hinweise

Wenn comparer ist null, wird der Standardmäßige Gleichheitsvergleich Default zum Vergleichen von Schlüsseln verwendet.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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>(IEnumerable<TSource>, Func<TSource,TKey>)

Quelle:
ToCollection.cs
Quelle:
ToCollection.cs
Quelle:
ToCollection.cs

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T> gemäß einer angegebenen Schlüsselauswahlfunktion

C#
public static System.Collections.Generic.Dictionary<TKey,TSource> ToDictionary<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

Typparameter

TSource

Der Typ der Elemente von source.

TKey

Der Typ des von keySelector zurückgegebenen Schlüssels.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein Dictionary<TKey,TValue> erstellt werden soll

keySelector
Func<TSource,TKey>

Eine Funktion zum Extrahieren eines Schlüssels aus jedem Element.

Gibt zurück

Dictionary<TKey,TSource>

Ein Dictionary<TKey,TValue>, das Schlüssel und Werte enthält. Die Werte in den einzelnen Gruppen liegen in der gleichen Reihenfolge vor wie in source.

Ausnahmen

source oder keySelector ist null.

- oder -

keySelector erzeugt einen Schlüssel, der null ist.

keySelector erzeugt für zwei Elemente doppelte Schlüssel.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) mithilfe einer Dictionary<TKey,TValue> Schlüsselauswahl ein erstellt wird.

C#
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
*/

Hinweise

Die ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) -Methode verwendet den Standardgleichvergleich Default , um Schlüssel zu vergleichen.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

Quelle:
ToCollection.cs
Quelle:
ToCollection.cs
Quelle:
ToCollection.cs

Erstellt ein Dictionary<TKey,TValue> aus einem IEnumerable<T> gemäß einer angegebenen Schlüsselauswahlfunktion und eines angegebenen Schlüsselvergleichs

C#
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);
C#
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);

Typparameter

TSource

Der Typ der Elemente von source.

TKey

Der Typ der von keySelector zurückgegebenen Schlüssel.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein Dictionary<TKey,TValue> erstellt werden soll

keySelector
Func<TSource,TKey>

Eine Funktion zum Extrahieren eines Schlüssels aus jedem Element.

comparer
IEqualityComparer<TKey>

Ein IEqualityComparer<T> zum Vergleichen von Schlüsseln.

Gibt zurück

Dictionary<TKey,TSource>

Ein Dictionary<TKey,TValue>, das Schlüssel und Werte enthält. Die Werte in den einzelnen Gruppen liegen in der gleichen Reihenfolge vor wie in source.

Ausnahmen

source oder keySelector ist null.

- oder -

keySelector erzeugt einen Schlüssel, der null ist.

keySelector erzeugt für zwei Elemente doppelte Schlüssel.

Hinweise

Wenn comparer ist null, wird der Standardmäßige Gleichheitsvergleich Default zum Vergleichen von Schlüsseln verwendet.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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