Enumerable.SkipWhile Método

  • Referencia

Definición

Espacio de nombres:
System.Linq
Ensamblado:
System.Linq.dll
Ensamblado:
System.Core.dll
Ensamblado:
netstandard.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
Source:
Skip.cs
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.

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.

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.

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

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

Se aplica a

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

Source:
Skip.cs
Source:
Skip.cs
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.

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.

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.

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

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

Se aplica a