Questa documentazione è stata archiviata e non viene gestita.

Metodo Enumerable.TakeWhile<TSource> (IEnumerable<TSource>, Func<TSource, Boolean>)

Aggiornamento: novembre 2007

Restituisce elementi di una sequenza finché una condizione specificata resta vera.

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

public static IEnumerable<TSource> TakeWhile<TSource>(
	this IEnumerable<TSource> source,
	Func<TSource, bool> predicate
)

J# supporta l'utilizzo di API generiche ma non la dichiarazione di nuove.
JScript non supporta i tipi o i metodi generici.

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source
Tipo: System.Collections.Generic.IEnumerable<TSource>

Sequenza dalla quale vengono restituiti gli elementi.

predicate
Tipo: System.Func<TSource, Boolean>

Funzione per testare ogni elemento rispetto a una condizione.

Valore restituito

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

Oggetto IEnumerable<T> che contiene gli elementi dalla sequenza di input che precedono il primo elemento che non soddisfa il test.

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 o predicate è 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.

Il metodo TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) verifica ogni elemento di source utilizzando predicate e restituisce l’elemento se il risultato è true. L'enumerazione si interrompe quando la funzione predicativa restituisce false per un elemento o quando source non contiene più elementi.

I metodi TakeWhile e SkipWhile sono complementi funzionali. Dato coll di sequenza e una funzione p pure, la concatenazione dei risultati di coll.TakeWhile(p) e coll.SkipWhile(p) produce la stessa sequenza di coll.

Nella sintassi di una espressione di query in Visual Basic, una clausola Take While viene convertita in una chiamata di TakeWhile.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) per restituire elementi dall'inizio di una sequenza finché una condizione è soddisfatta.

string[] fruits = { "apple", "banana", "mango", "orange", 
                      "passionfruit", "grape" };

IEnumerable<string> query =
    fruits.TakeWhile(fruit => String.Compare("orange", fruit, true) != 0);

foreach (string fruit in query)
{
    Console.WriteLine(fruit);
}

/*
 This code produces the following output:

 apple
 banana
 mango
*/



Windows Vista, Windows XP SP2, Windows Server 2003, Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC

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

.NET Framework

Supportato in: 3.5

.NET Compact Framework

Supportato in: 3.5
Mostra: