Enumerable.Reverse<TSource>(IEnumerable<TSource>) Methode

Definition

Namespace:

System.Linq

Assembly:

System.Core.dll

Invertiert die Reihenfolge der Elemente in einer Sequenz.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ Reverse(System::Collections::Generic::IEnumerable<TSource> ^ source);

public static System.Collections.Generic.IEnumerable<TSource> Reverse<TSource>(this System.Collections.Generic.IEnumerable<TSource> source);

static member Reverse : seq<'Source> -> seq<'Source>

<Extension()>
Public Function Reverse(Of TSource) (source As IEnumerable(Of TSource)) As IEnumerable(Of TSource)

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IEnumerable<TSource>

Eine Abfolge von Werten, die umgekehrt werden sollen.

Gibt zurück

IEnumerable<TSource>

Eine Sequenz, deren Elemente denen der Eingabesequenz in umgekehrter Reihenfolge entsprechen.

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Reverse die Reihenfolge von Elementen in einem Array umgekehrt wird.

char[] apple = { 'a', 'p', 'p', 'l', 'e' };

char[] reversed = apple.Reverse().ToArray();

foreach (char chr in reversed)
{
    Console.Write(chr + " ");
}
Console.WriteLine();

/*
 This code produces the following output:

 e l p p a
*/

' Create a List of Char values.
Dim appleLetters As New List(Of Char)(New Char() _
                                  {"a"c, "P"c, "P"c, "L"c, "E"c})

' Reverse the order of the elements in the list.
' (We have to call AsEnumerable() in order to
' use System.Linq.Enumerable's Reverse() method.
Dim reversed() As Char =
appleLetters.AsEnumerable().Reverse().ToArray()

Dim output As New System.Text.StringBuilder
For Each chr As Char In reversed
    output.Append(chr & " ")
Next

' Display the output.
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' E L P P a

Hinweise

Diese Methode wird mithilfe der verzögerten Ausführung implementiert. Der sofortige Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind. Die durch diese Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt aufgezählt wird, indem die GetEnumerator-Methode direkt oder mithilfe von foreach in C# oder For Each in Visual Basic aufgerufen wird.

Im Gegensatz dazu OrderByberücksichtigt diese Sortiermethode nicht die tatsächlichen Werte selbst bei der Bestimmung der Reihenfolge. Stattdessen werden nur die Elemente in umgekehrter Reihenfolge zurückgegeben, aus der sie von der zugrunde liegenden Quelle erzeugt werden.