Enumerable.Take Yöntem

Tanım

Aşırı Yüklemeler

Take<TSource>(IEnumerable<TSource>, Int32)

Bir dizinin başlangıcından belirtilen sayıda bitişik öğe döndürür.

Take<TSource>(IEnumerable<TSource>, Range)

Bir diziden belirli bir bitişik öğe aralığını döndürür.

Take<TSource>(IEnumerable<TSource>, Int32)

Kaynak:
Take.cs
Kaynak:
Take.cs
Kaynak:
Take.cs

Bir dizinin başlangıcından belirtilen sayıda bitişik öğe döndürür.

C#
public static System.Collections.Generic.IEnumerable<TSource> Take<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int count);

Tür Parametreleri

TSource

öğelerinin sourcetürü.

Parametreler

source
IEnumerable<TSource>

Öğesinden öğe döndürülecek dizi.

count
Int32

Döndürülecek öğe sayısı.

Döndürülenler

IEnumerable<TSource>

IEnumerable<T> Giriş dizisinin başından itibaren belirtilen sayıda öğeyi içeren bir.

Özel durumlar

source, null değeridir.

Örnekler

Aşağıdaki kod örneği, bir dizinin başlangıcından öğeleri döndürmek için nasıl kullanılacağını Take gösterir.

C#
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
*/

Açıklamalar

Bu yöntem ertelenmiş yürütme kullanılarak uygulanır. Anında dönüş değeri, eylemi gerçekleştirmek için gereken tüm bilgileri depolayan bir nesnedir. Bu yöntemle temsil edilen sorgu, doğrudan yöntemini çağırarak GetEnumerator veya C# içinde veya For Each Visual Basic'te kullanarak foreach nesne numaralandırılana kadar yürütülür.

Takeöğeler teslim edilene veya başka öğe içermeyene kadar count öğeleri numaralandırır source ve source verir. içindeki sourceöğe sayısını aşarsa count tüm öğeleri source döndürülür.

Sıfırdan küçük veya sıfıra eşitse count numaralandırılmaz source ve boş IEnumerable<T> bir değer döndürülür.

Take ve Skip yöntemleri işlevsel tamamlayıcılardır. Bir koleksiyon dizisi coll ve bir tamsayı verilip nve sonuçlarını coll.Take(n)coll.Skip(n) birleştirerek ile aynı sırayı collverir.

Visual Basic sorgu ifadesi söz diziminde yan Take tümcesi çağrısına çevrilir Take.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Take<TSource>(IEnumerable<TSource>, Range)

Kaynak:
Take.cs
Kaynak:
Take.cs
Kaynak:
Take.cs

Bir diziden belirli bir bitişik öğe aralığını döndürür.

C#
public static System.Collections.Generic.IEnumerable<TSource> Take<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Range range);

Tür Parametreleri

TSource

öğelerinin sourcetürü.

Parametreler

source
IEnumerable<TSource>

Öğesinden öğe döndürülecek dizi.

range
Range

Dizinin başından veya sonundan başlangıç ve bitiş dizinlerine sahip, döndürülecek öğe aralığı.

Döndürülenler

IEnumerable<TSource>

IEnumerable<T> Diziden source belirtilen öğe aralığını içeren bir.

Özel durumlar

source, null değeridir.

Açıklamalar

Bu yöntem ertelenmiş yürütme kullanılarak uygulanır. Anında dönüş değeri, eylemi gerçekleştirmek için gereken tüm bilgileri depolayan bir nesnedir. Bu yöntemle temsil edilen sorgu, doğrudan yöntemini çağırarak GetEnumerator veya C# içinde veya For Each Visual Basic'te kullanarak foreach nesne numaralandırılana kadar yürütülür.

Take dizinleri source belirtilen rangeöğesine ait olan öğeleri numaralandırır ve verir.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9