Enumerable.SkipWhile Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.dll

Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.

Sobrecargas

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.
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. El índice del elemento se usa en la lógica de la función de predicado.

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

Source:

Skip.cs

Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.

C#

public static System.Collections.Generic.IEnumerable<TSource> SkipWhile<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> del que se van a devolver los elementos.

predicate

Func<TSource,Boolean>

Función para probar cada elemento de una condición.

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.

Excepciones

ArgumentNullException

source o predicate es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) para omitir elementos de una matriz siempre y cuando se cumpla una condición.

C#

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

Comentarios

El SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su GetEnumerator método o mediante foreach en C# o For Each en Visual Basic.

Este método prueba cada elemento de source mediante predicate y omite el elemento si el resultado es true. Después de que la función de predicado devuelva false para un elemento , ese elemento y los elementos restantes de source se producen y no hay más invocaciones de predicate.

Si predicate devuelve true para todos los elementos de la secuencia, se devuelve un valor vacío IEnumerable<T> .

Los TakeWhile métodos y SkipWhile son complementarios funcionales. Dada una secuencia coll de colección y una función ppura, concatenando los resultados de coll.TakeWhile(p) y coll.SkipWhile(p) produce la misma secuencia que coll.

En la sintaxis de la expresión de consulta de Visual Basic, una Skip While cláusula se traduce en una invocación de SkipWhile.

Consulte también

• Skip While (Cláusula, Visual Basic)

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

Source:

Skip.cs

Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes. El índice del elemento se usa en la lógica de la función de predicado.

C#

public static System.Collections.Generic.IEnumerable<TSource> SkipWhile<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,bool> predicate);

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> del que se van a devolver los elementos.

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.

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.

Excepciones

ArgumentNullException

source o predicate es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) para omitir elementos de una matriz siempre que una condición que dependa del índice del elemento sea true.

C#

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

Comentarios

Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su GetEnumerator método o mediante foreach en C# o For Each en Visual Basic.

El SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) método prueba cada elemento de source mediante predicate y omite el elemento si el resultado es true. Después de que la función de predicado devuelva false para un elemento , ese elemento y los elementos restantes de source se producen y no hay más invocaciones de predicate.

Si predicate devuelve true para todos los elementos de la secuencia, se devuelve un valor vacío IEnumerable<T> .

El primer argumento de predicate representa el elemento que se va a probar. El segundo argumento representa el índice de base cero del elemento dentro de source.

Los TakeWhile métodos y SkipWhile son complementarios funcionales. Dada una secuencia coll de colección y una función ppura, concatenando los resultados de coll.TakeWhile(p) y coll.SkipWhile(p) produce la misma secuencia que coll.

En la sintaxis de la expresión de consulta de Visual Basic, una Skip While cláusula se traduce en una invocación de SkipWhile.

Consulte también

• Skip While (Cláusula, Visual Basic)