Windows Dev Center

Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale
Informazioni
L'argomento richiesto è visualizzato di seguito, ma non è incluso in questa libreria.

Metodo Enumerable.Take<TSource>

Restituisce un numero specificato di elementi contigui dall'inizio di una sequenza.

Spazio dei nomi:  System.Linq
Assembly:  System.Core (in System.Core.dll)

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

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source
Tipo: System.Collections.Generic.IEnumerable<TSource>
Sequenza dalla quale vengono restituiti gli elementi.
count
Tipo: System.Int32
Numero di elementi da restituire.

Valore restituito

Tipo: System.Collections.Generic.IEnumerable<TSource>
Oggetto IEnumerable<T> che contiene il numero specificato di elementi, dall'inizio della sequenza di input.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IEnumerable<TSource>. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

EccezioneCondizione
ArgumentNullException

source è null.

Questo metodo viene implementato tramite esecuzione posticipata. Il valore restituito immediato è un oggetto che contiene tutte le informazioni necessarie all'esecuzione dell'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato tramite chiamata diretta al relativo metodo GetEnumerator o utilizzando l'oggetto foreach in Visual C# oppure For Each in Visual Basic.

Take<TSource> enumera source e restituisce elementi fino a che sono stati prodotti count elementi o source non contiene più elementi. Se count supera il numero di elementi in source, tutti gli elementi di source vengono restituiti.

Se count è minore o uguale a zero, source non viene enumerato e viene restituito un oggetto IEnumerable<T> vuoto.

I metodi Take<TSource> e Skip<TSource> sono complementi funzionali. Data una sequenza coll e un valore intero n, la concatenazione dei risultati di coll.Take(n) e coll.Skip(n) produce la stessa sequenza di coll.

Nella sintassi di una espressione di query in Visual Basic, una clausola Take viene convertita in una chiamata di Take<TSource>.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare Take<TSource> per restituire elementi dall'inizio di una sequenza.


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



.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

Mostra:
© 2015 Microsoft