Windows app
摺疊目錄
展開目錄
本文章是由機器翻譯。 將指標移到文章內的文字上方即可查看原文。 其他資訊。
譯文
原文
資訊
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Enumerable.Take<TSource> 方法 (IEnumerable<TSource>, Int32)

 

從序列開頭傳回指定的連續項目數目。

命名空間:   System.Linq
組件:  System.Core (在 System.Core.dll 中)

public static IEnumerable<TSource> Take<TSource>(
	this IEnumerable<TSource> source,
	int count
)

參數

source

傳回項目的序列。

count

要傳回的項目數目。

傳回值

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

IEnumerable<T>,其中包含輸入序列開頭處指定的項目數目。

類型參數

TSource

source 之項目的型別。

Exception Condition
ArgumentNullException

sourcenull

這個方法是利用延遲執行所實作。立即傳回值是一個物件,儲存執行該動作所需的所有資訊。這個方法所代表的查詢必須等到列舉物件 (透過直接呼叫其 GetEnumerator 方法,或是使用 Visual C# 中的 foreach 或 Visual Basic 中的 For Each) 之後才會執行。

Take<TSource> 會列舉 source 並產生項目,直到產生 count 個項目或 source 中已經沒有其他項目為止。如果 count 超出 source中的項目數, source 的所有元素傳回。

如果 count 小於或等於零,則不會列舉 source,並傳回空白的 IEnumerable<T>

Take<TSource>Skip<TSource> 方法都是功能補充方法。假設有序列 coll 和整數 n,串連 coll.Take(n)coll.Skip(n) 後將產生與 coll 相同的序列。

在 Visual Basic 查詢運算式語法中,Take 子句會轉譯為 Take<TSource> 的引動過程。

下列程式碼範例示範如何使用 Take<TSource> 從序列開頭傳回項目。

int[] grades = { 59, 82, 70, 56, 92, 98, 85 };

IEnumerable<int> topThreeGrades =
    grades.OrderByDescending(grade => grade).Take(3);

Console.WriteLine("The top three grades are:");
foreach (int grade in topThreeGrades)
{
    Console.WriteLine(grade);
}
/*
 This code produces the following output:

 The top three grades are:
 98
 92
 85
*/

Universal Windows Platform
自 4.5 起可用
.NET Framework
自 3.5 起可用
Portable Class Library
支援版本:portable .NET platforms
Silverlight
自 2.0 起可用
Windows Phone Silverlight
自 7.0 起可用
Windows Phone
自 8.1 起可用
回到頁首
顯示:
© 2016 Microsoft