Enumerable.SkipWhile Metodo

Definizione

Ignora gli elementi in sequenza finché la condizione specificata è soddisfatta e quindi restituisce gli elementi rimanenti.Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements.

Overload

SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Ignora gli elementi in sequenza finché la condizione specificata è soddisfatta e quindi restituisce gli elementi rimanenti.Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements.

SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)

Ignora gli elementi in sequenza finché la condizione specificata è soddisfatta e quindi restituisce gli elementi rimanenti.Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. L'indice dell'elemento viene usato nella logica della funzione predicativa.The element's index is used in the logic of the predicate function.

SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Ignora gli elementi in sequenza finché la condizione specificata è soddisfatta e quindi restituisce gli elementi rimanenti.Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ SkipWhile(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);
public static System.Collections.Generic.IEnumerable<TSource> SkipWhile<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);
static member SkipWhile : seq<'Source> * Func<'Source, bool> -> seq<'Source>
<Extension()>
Public Function SkipWhile(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As IEnumerable(Of TSource)

Parametri di tipo

TSource

Tipo degli elementi di source.The type of the elements of source.

Parametri

source
IEnumerable<TSource>

Oggetto IEnumerable<T> dal quale restituire elementi.An IEnumerable<T> to return elements from.

predicate
Func<TSource,Boolean>

Funzione per testare ogni elemento rispetto a una condizione.A function to test each element for a condition.

Restituisce

IEnumerable<TSource>

Oggetto IEnumerable<T> che contiene gli elementi dalla sequenza di input a partire dal primo elemento nella serie lineare che non supera il test specificato da predicate.An IEnumerable<T> that contains the elements from the input sequence starting at the first element in the linear series that does not pass the test specified by predicate.

Eccezioni

source o predicate è null.source or predicate is null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) per ignorare gli elementi di una matrice finché una condizione è true.The following code example demonstrates how to use SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) to skip elements of an array as long as a condition is true.

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

IEnumerable<int> lowerGrades =
    grades
    .OrderByDescending(grade => grade)
    .SkipWhile(grade => grade >= 80);

Console.WriteLine("All grades below 80:");
foreach (int grade in lowerGrades)
{
    Console.WriteLine(grade);
}

/*
 This code produces the following output:

 All grades below 80:
 70
 59
 56
*/
' Create an array of integers that represent grades.
Dim grades() As Integer = {59, 82, 70, 56, 92, 98, 85}

' Sort the grades in descending order and
' get all grades greater less than 80.
Dim lowerGrades As IEnumerable(Of Integer) =
grades _
.OrderByDescending(Function(grade) grade) _
.SkipWhile(Function(grade) grade >= 80)

' Display the results.
Dim output As New System.Text.StringBuilder("All grades below 80:" & vbCrLf)
For Each grade As Integer In lowerGrades
    output.AppendLine(grade)
Next
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' All grades below 80:
' 70
' 59
' 56

Commenti

Il metodo SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) viene implementato utilizzando l'esecuzione posticipata.The SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method is implemented by using deferred execution. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione.The immediate return value is an object that stores all the information that is required to perform the action. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato chiamando il relativo metodo GetEnumerator direttamente o utilizzando foreach in Visual C# o For Each in Visual Basic.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

Questo metodo testa ogni elemento di source usando predicate e ignora l'elemento se il risultato è true.This method tests each element of source by using predicate and skips the element if the result is true. Dopo che la funzione predicato restituisce false per un elemento, l'elemento e gli elementi rimanenti nel source vengono restituiti e non ci sono più chiamate di predicate.After the predicate function returns false for an element, that element and the remaining elements in source are yielded and there are no more invocations of predicate.

Se predicate restituisce true per tutti gli elementi della sequenza, viene restituita una IEnumerable<T> vuota.If predicate returns true for all elements in the sequence, an empty IEnumerable<T> is returned.

I metodi TakeWhile e SkipWhile sono complementi funzionali.The TakeWhile and SkipWhile methods are functional complements. Dato un coll di sequenza e una funzione pura p, la concatenazione dei risultati di coll.TakeWhile(p) e coll.SkipWhile(p) restituisce la stessa sequenza di coll.Given a sequence coll and a pure function p, concatenating the results of coll.TakeWhile(p) and coll.SkipWhile(p) yields the same sequence as coll.

In Visual Basic sintassi delle espressioni di query, una clausola Skip While si traduce in una chiamata di SkipWhile.In Visual Basic query expression syntax, a Skip While clause translates to an invocation of SkipWhile.

Vedi anche

SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)

Ignora gli elementi in sequenza finché la condizione specificata è soddisfatta e quindi restituisce gli elementi rimanenti.Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. L'indice dell'elemento viene usato nella logica della funzione predicativa.The element's index is used in the logic of the predicate function.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ SkipWhile(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int, bool> ^ predicate);
public static System.Collections.Generic.IEnumerable<TSource> SkipWhile<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,bool> predicate);
static member SkipWhile : seq<'Source> * Func<'Source, int, bool> -> seq<'Source>
<Extension()>
Public Function SkipWhile(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Integer, Boolean)) As IEnumerable(Of TSource)

Parametri di tipo

TSource

Tipo degli elementi di source.The type of the elements of source.

Parametri

source
IEnumerable<TSource>

Oggetto IEnumerable<T> dal quale restituire elementi.An IEnumerable<T> to return elements from.

predicate
Func<TSource,Int32,Boolean>

Funzione per verificare ogni elemento di origine per una condizione; il secondo parametro della funzione rappresenta l'indice dell'elemento di origine.A function to test each source element for a condition; the second parameter of the function represents the index of the source element.

Restituisce

IEnumerable<TSource>

Oggetto IEnumerable<T> che contiene gli elementi dalla sequenza di input a partire dal primo elemento nella serie lineare che non supera il test specificato da predicate.An IEnumerable<T> that contains the elements from the input sequence starting at the first element in the linear series that does not pass the test specified by predicate.

Eccezioni

source o predicate è null.source or predicate is null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) per ignorare gli elementi di una matrice purché una condizione che dipende dall'indice dell'elemento sia true.The following code example demonstrates how to use SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) to skip elements of an array as long as a condition that depends on the element's index is true.

int[] amounts = { 5000, 2500, 9000, 8000,
                    6500, 4000, 1500, 5500 };

IEnumerable<int> query =
    amounts.SkipWhile((amount, index) => amount > index * 1000);

foreach (int amount in query)
{
    Console.WriteLine(amount);
}

/*
 This code produces the following output:

 4000
 1500
 5500
*/
' Create an array of integers.
Dim amounts() As Integer =
{5000, 2500, 9000, 8000, 6500, 4000, 1500, 5500}

' Skip items in the array whose value is greater than
' the item's index times 1000; get the remaining items.
Dim query As IEnumerable(Of Integer) =
amounts.SkipWhile(Function(amount, index) _
                      amount > index * 1000)

' Output the results.
Dim output As New System.Text.StringBuilder
For Each amount As Integer In query
    output.AppendLine(amount)
Next
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' 4000
' 1500
' 5500

Commenti

Questo metodo viene implementato tramite l'esecuzione posticipata.This method is implemented by using deferred execution. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione.The immediate return value is an object that stores all the information that is required to perform the action. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato chiamando il relativo metodo GetEnumerator direttamente o utilizzando foreach in Visual C# o For Each in Visual Basic.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

Il metodo SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) verifica ogni elemento di source utilizzando predicate e ignora l'elemento se il risultato è true.The SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) method tests each element of source by using predicate and skips the element if the result is true. Dopo che la funzione predicato restituisce false per un elemento, l'elemento e gli elementi rimanenti nel source vengono restituiti e non ci sono più chiamate di predicate.After the predicate function returns false for an element, that element and the remaining elements in source are yielded and there are no more invocations of predicate.

Se predicate restituisce true per tutti gli elementi della sequenza, viene restituita una IEnumerable<T> vuota.If predicate returns true for all elements in the sequence, an empty IEnumerable<T> is returned.

Il primo argomento di predicate rappresenta l'elemento da testare.The first argument of predicate represents the element to test. Il secondo argomento rappresenta l'indice in base zero dell'elemento all'interno source.The second argument represents the zero-based index of the element within source.

I metodi TakeWhile e SkipWhile sono complementi funzionali.The TakeWhile and SkipWhile methods are functional complements. Dato un coll di sequenza e una funzione pura p, la concatenazione dei risultati di coll.TakeWhile(p) e coll.SkipWhile(p) restituisce la stessa sequenza di coll.Given a sequence coll and a pure function p, concatenating the results of coll.TakeWhile(p) and coll.SkipWhile(p) yields the same sequence as coll.

In Visual Basic sintassi delle espressioni di query, una clausola Skip While si traduce in una chiamata di SkipWhile.In Visual Basic query expression syntax, a Skip While clause translates to an invocation of SkipWhile.

Vedi anche

Si applica a