Enumerable.ThenByDescending<TSource, TKey>-Methode (IOrderedEnumerable<TSource>, Func<TSource, TKey>, IComparer<TKey>)

public static IOrderedEnumerable<TSource> ThenByDescending<TSource, TKey>(
	this IOrderedEnumerable<TSource> source,
	Func<TSource, TKey> keySelector,
	IComparer<TKey> comparer
)

Hinweis zur Verwendung

Diese Methode wird mit verzögerter Ausführung implementiert. Der Wert der sofortigen Rückgabe ist ein Objekt, in dem alle zum Ausführen der Aktion erforderlichen Informationen gespeichert werden. Die von dieser Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt entweder durch den direkten Aufruf der zugehörigen GetEnumerator-Methode oder mithilfe von foreach in Visual C# oder For Each in Visual Basic aufgelistet wird.

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

ThenBy und ThenByDescending sind definiert, um den Typ IOrderedEnumerable<TElement> zu erweitern, der auch der Rückgabetyp dieser Methoden ist. Mithilfe dieses Entwurfs können Sie mehrere Sortierkriterien angeben, indem Sie eine beliebige Anzahl von ThenBy-Methoden oder ThenByDescending-Methoden anwenden.

Hinweis
Weil IOrderedEnumerable<TElement> von IEnumerable<T> erbt, können Sie OrderBy oder OrderByDescending für die Ergebnisse eines Aufrufs von OrderBy, OrderByDescending, ThenBy oder ThenByDescending aufrufen. Hierdurch erfolgt eine neue primäre Sortierung, die die zuvor festgelegte Sortierung ignoriert.

Wenn comparernull ist, werden Schlüssel mithilfe des Standardvergleichs Default verglichen.

Diese Methode führt eine stabile Sortierung aus, d. h., bei zwei Elementen mit gleichem Schlüssel wird die Reihenfolge der Elemente beibehalten. Im Gegensatz dazu wird bei einer instabilen Sortierung die Reihenfolge von Elementen, die über den gleichen Schlüssel verfügen, nicht beibehalten.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit ThenByDescending<TSource, TKey>(IOrderedEnumerable<TSource>, Func<TSource, TKey>, IComparer<TKey>) und unter Verwendung eines benutzerdefinierten Vergleichs eine nachfolgende Sortierung in absteigender Reihenfolge der Elemente in einer Sequenz durchführen.

            public class CaseInsensitiveComparer : IComparer<string>
            {
                public int Compare(string x, string y)
                {
                    return string.Compare(x, y, true);
                }
            }

            public static void ThenByDescendingEx1()
            {
                string[] fruits = { "apPLe", "baNanA", "apple", "APple", "orange", "BAnana", "ORANGE", "apPLE" };

                // Sort the strings first ascending by their length and 
                // then descending using a custom case insensitive comparer.
                IEnumerable<string> query =
                    fruits
                    .OrderBy(fruit => fruit.Length)
                    .ThenByDescending(fruit => fruit, new CaseInsensitiveComparer());

                foreach (string fruit in query)
                {
                    Console.WriteLine(fruit);
                }
            }

            /*
                This code produces the following output:

                apPLe
                apple
                APple
                apPLE
                orange
                ORANGE
                baNanA
                BAnana
            */

.NET Framework

.NET Framework Client Profile

Portable Klassenbibliothek

.NET für Windows Store-Apps

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz