Enumerable.Reverse<TSource>(IEnumerable<TSource>) Méthode

Définition

Inverse l'ordre des éléments dans une séquence.Inverts the order of the elements in a sequence.

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)

Paramètres de type

TSource

Le type des éléments de source.The type of the elements of source.

Paramètres

source
IEnumerable<TSource>

Séquence de valeurs à inverser.A sequence of values to reverse.

Retours

IEnumerable<TSource>

Séquence dont les éléments correspondent à ceux de la séquence d'entrée dans l'ordre inverse.A sequence whose elements correspond to those of the input sequence in reverse order.

Exceptions

source a la valeur null.source is null.

Exemples

L’exemple de code suivant montre comment utiliser Reverse pour inverser l’ordre des éléments dans un tableau.The following code example demonstrates how to use Reverse to reverse the order of elements in an array.

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

Remarques

Cette méthode est implémentée à l’aide de l’exécution différée.This method is implemented by using deferred execution. La valeur de retour immédiate est un objet qui stocke toutes les informations requises pour effectuer l’action.The immediate return value is an object that stores all the information that is required to perform the action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré soit en appelant sa méthode GetEnumerator directement, soit C# en utilisant foreach dans Visual ou For Each dans Visual Basic.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

Contrairement à OrderBy, cette méthode de tri ne tient pas compte des valeurs réelles pour déterminer l’ordre.Unlike OrderBy, this sorting method does not consider the actual values themselves in determining the order. Au lieu de cela, il retourne simplement les éléments dans l’ordre inverse à partir duquel ils sont produits par la source sous-jacente.Rather, it just returns the elements in the reverse order from which they are produced by the underlying source.

S’applique à