Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Enumerable.OrderByDescending<TSource, TKey>-Methode: (IEnumerable<TSource>, Func<TSource, TKey>)

 

Veröffentlicht: Oktober 2016

Sortiert die Elemente einer Sequenz in absteigender Reihenfolge nach einem Schlüssel.

Namespace:   System.Linq
Assembly:  System.Core (in System.Core.dll)

public static IOrderedEnumerable<TSource> OrderByDescending<TSource, TKey>(
	this IEnumerable<TSource> source,
	Func<TSource, TKey> keySelector
)

Parameter

source
Type: System.Collections.Generic.IEnumerable<TSource>

Eine Sequenz von anzuordnenden Werten.

keySelector
Type: System.Func<TSource, TKey>

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

Rückgabewert

Type: System.Linq.IOrderedEnumerable<TSource>

Ein IOrderedEnumerable<TElement> dessen Elemente in absteigender Reihenfolge nach einem Schlüssel sortiert werden.

Typparameter

TSource

Der Typ der Elemente von source.

TKey

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

Exception Condition
ArgumentNullException

source oder keySelector ist null.

Diese Methode wird mit verzögerter Ausführung implementiert. Der sofortige Rückgabewert ist ein Objekt, das alle Informationen gespeichert hat, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird nicht ausgeführt, bis das Objekt aufgelistet wird, entweder durch Aufrufen der GetEnumerator -Methode direkt oder mithilfe von foreach in Visual C# oder For Each in Visual Basic.

Um eine Sequenz nach den Werten der Elemente selbst zu sortieren, geben Sie die Identity-Funktion (x => x in Visual C# oder Function(x) x in Visual Basic) für keySelector.

Ein Beispiel für diese Methode, finden Sie unter OrderByDescending<TSource, TKey>(IEnumerable<TSource>, Func<TSource, TKey>, IComparer<TKey>).

Sind zwei Methoden definiert, um den Typ erweitern IOrderedEnumerable<TElement>, dies ist der Rückgabetyp dieser Methode. Diese zwei Methoden, nämlich ThenBy und ThenByDescending, können Sie zusätzliche Kriterien zum Sortieren einer Sequenz angeben. ThenBy und ThenByDescending auch Zurückgeben einer IOrderedEnumerable<TElement>, was bedeutet, dass eine beliebige Anzahl aufeinander folgender Aufrufe von ThenBy oder ThenByDescending erfolgen.

System_CAPS_noteHinweis

Da IOrderedEnumerable<TElement> erbt von IEnumerable<T>, rufen Sie OrderBy oder OrderByDescending auf die Ergebnisse eines Aufrufs von OrderBy, OrderByDescending, ThenBy oder ThenByDescending. Auf diese Weise führt eine neue primäre Sortierung, die die zuvor festgelegte Sortierung ignoriert.

Diese Methode vergleicht Schlüssel mithilfe des Standardvergleichs Default.

Diese Methode führt eine stabile Sortierung. Das heißt, ist die Schlüssel der zwei Elemente gleich sind, die Reihenfolge der Elemente beibehalten. Im Gegensatz dazu behält eine instabile Sortierung die Reihenfolge der Elemente nicht den gleichen Schlüssel verfügen.

In der Abfrageausdruckssyntax ein orderby descending (Visual C#) oder Order By Descending (Visual Basic)-Klausel übersetzt in einen Aufruf von OrderByDescending.

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 3.5
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: