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 cómo usar SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) para omitir los elementos de una matriz como una condición es 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
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 se enumera el objeto llamando a su GetEnumerator método directamente o mediante 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 comprueba cada elemento de source utilizando predicate 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. Después de la función de predicado devuelve false para un elemento, ese elemento y los elementos restantes en source se produjo y no hay ningún 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 devuelve true para todos los elementos de la secuencia, un valor vacío IEnumerable<T> se devuelve.If predicate returns true for all elements in the sequence, an empty IEnumerable<T> is returned.

El TakeWhile y SkipWhile métodos son complementos funcionales.The TakeWhile and SkipWhile methods are functional complements. En una secuencia coll y una función pura p, concatenar los resultados de coll.TakeWhile(p) y coll.SkipWhile(p) da como resultado la misma secuencia que 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.

En la sintaxis de expresión de consulta de Visual Basic, un Skip While cláusula se convierte en una invocación de SkipWhile.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 cómo usar SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) para omitir los elementos de una matriz como una condición que depende el índice del elemento es 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 se enumera el objeto llamando a su GetEnumerator método directamente o mediante 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 utilizando predicate 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. Después de la función de predicado devuelve false para un elemento, ese elemento y los elementos restantes en source se produjo y no hay ningún 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 devuelve true para todos los elementos de la secuencia, un valor vacío IEnumerable<T> se devuelve.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 de source.The second argument represents the zero-based index of the element within source.

El TakeWhile y SkipWhile métodos son complementos funcionales.The TakeWhile and SkipWhile methods are functional complements. En una secuencia coll y una función pura p, concatenar los resultados de coll.TakeWhile(p) y coll.SkipWhile(p) da como resultado la misma secuencia que 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.

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

Consulte también:

Se aplica a