Enumerable.SkipWhile Enumerable.SkipWhile Enumerable.SkipWhile Enumerable.SkipWhile Method

Definición

Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements.

Sobrecargas

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

Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.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>) SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)

Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. El índice del elemento se usa en la lógica de la función de predicado.The element's index is used in the logic of the predicate function.

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

Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.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)

Parámetros de tipo

TSource

Tipo de los elementos de source.The type of the elements of source.

Parámetros

source
IEnumerable<TSource>

IEnumerable<T> del que se van a devolver los elementos.An IEnumerable<T> to return elements from.

predicate
Func<TSource,Boolean>

Función para probar cada elemento de una condición.A function to test each element for a condition.

Devoluciones

IEnumerable<TSource>

IEnumerable<T> que contiene los elementos de la secuencia de entrada comenzando por el primer elemento de la serie lineal que no pasa la prueba especificada en 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.

Excepciones

source o predicate es null.source or predicate is null.

Ejemplos

En el ejemplo de código siguiente se muestra SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) cómo usar para omitir los elementos de una matriz siempre que se cumpla una condición.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
MsgBox(output.ToString())

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

Comentarios

El SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) método se implementa mediante la ejecución aplazada.The SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method is implemented by using deferred execution. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción.The immediate return value is an object that stores all the information that is required to perform the action. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando a GetEnumerator su método directamente o usando foreach en Visual C# o For Each en 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.

Este método prueba cada elemento de source predicate mediante y omite el elemento si el resultado es true.This method tests each element of source by using predicate and skips the element if the result is true. Una vez que la función false de predicado devuelve para un elemento, se producen ese source elemento y los restantes elementos de en y no hay más invocaciones de 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.

Si predicate IEnumerable<T> devuelve true para todos los elementos de la secuencia, se devuelve un vacío.If predicate returns true for all elements in the sequence, an empty IEnumerable<T> is returned.

Los TakeWhile métodos SkipWhile y son complementos funcionales.The TakeWhile and SkipWhile methods are functional complements. Dada una secuencia coll y una función ppura, la concatenación de los coll.TakeWhile(p) resultados coll.SkipWhile(p) de y produce la misma secuencia collque.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.

En Visual Basic sintaxis de expresiones de consulta Skip While , una cláusula se convierte en una invocación SkipWhilede.In Visual Basic query expression syntax, a Skip While clause translates to an invocation of SkipWhile.

Consulte también:

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

Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. El índice del elemento se usa en la lógica de la función de predicado.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)

Parámetros de tipo

TSource

Tipo de los elementos de source.The type of the elements of source.

Parámetros

source
IEnumerable<TSource>

IEnumerable<T> del que se van a devolver los elementos.An IEnumerable<T> to return elements from.

predicate
Func<TSource,Int32,Boolean>

Función que va a probar cada elemento de origen para determinar si satisface una condición; el segundo parámetro de la función representa el índice del elemento de origen.A function to test each source element for a condition; the second parameter of the function represents the index of the source element.

Devoluciones

IEnumerable<TSource>

IEnumerable<T> que contiene los elementos de la secuencia de entrada comenzando por el primer elemento de la serie lineal que no pasa la prueba especificada en 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.

Excepciones

source o predicate es null.source or predicate is null.

Ejemplos

En el ejemplo de código siguiente se muestra SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) cómo usar para omitir los elementos de una matriz siempre que una condición que dependa del índice del elemento sea 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
MsgBox(output.ToString())

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

Comentarios

Este método se implementa mediante la ejecución aplazada.This method is implemented by using deferred execution. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción.The immediate return value is an object that stores all the information that is required to perform the action. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando a GetEnumerator su método directamente o usando foreach en Visual C# o For Each en 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.

El SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) método prueba cada elemento de source predicate mediante y omite el elemento si el resultado es 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. Una vez que la función false de predicado devuelve para un elemento, se producen ese source elemento y los restantes elementos de en y no hay más invocaciones de 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.

Si predicate IEnumerable<T> devuelve true para todos los elementos de la secuencia, se devuelve un vacío.If predicate returns true for all elements in the sequence, an empty IEnumerable<T> is returned.

El primer argumento de predicate representa el elemento que se va a probar.The first argument of predicate represents the element to test. El segundo argumento representa el índice de base cero del elemento dentro sourcede.The second argument represents the zero-based index of the element within source.

Los TakeWhile métodos SkipWhile y son complementos funcionales.The TakeWhile and SkipWhile methods are functional complements. Dada una secuencia coll y una función ppura, la concatenación de los coll.TakeWhile(p) resultados coll.SkipWhile(p) de y produce la misma secuencia collque.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.

En Visual Basic sintaxis de expresiones de consulta Skip While , una cláusula se convierte en una invocación SkipWhilede.In Visual Basic query expression syntax, a Skip While clause translates to an invocation of SkipWhile.

Consulte también:

Se aplica a