Enumerable.Reverse<TSource>(IEnumerable<TSource>) 方法

定義

命名空間:

System.Linq

組件:

System.Linq.dll

來源:

Reverse.cs

反轉序列中項目的排序方向。

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)

類型參數

TSource

source 項目的類型。

參數

source

IEnumerable<TSource>

要反轉方向的值序列。

傳回

IEnumerable<TSource>

其項目對應於輸入序列中反向排序之項目的序列。

例外狀況

ArgumentNullException

source 為 null。

範例

下列程式代碼範例示範如何使用 Reverse 來反轉數位列中的元素順序。

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

備註

這個方法是使用延後執行來實作。 立即傳回值是一個物件，會儲存執行動作所需的所有資訊。 除非直接呼叫其 GetEnumerator 方法或在 C# 或 foreachFor Each Visual Basic 中使用 來列舉對象，否則不會執行這個方法所代表的查詢。

不同於 OrderBy，這個排序方法不會在判斷順序時考慮實際值本身。 相反地，它只會以基礎來源所產生的反向順序傳回元素。