Queryable.TakeWhile Método

Definición

Devuelve los elementos de una secuencia siempre que el valor de una condición especificada sea true y luego omite los elementos restantes.Returns elements from a sequence as long as a specified condition is true, and then skips the remaining elements.

Sobrecargas

TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

Devuelve los elementos de una secuencia en tanto que el valor de una condición especificada sea true.Returns elements from a sequence as long as a specified condition is true.

TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>)

Devuelve los elementos de una secuencia en tanto que el valor de una condición especificada sea true.Returns elements from a sequence as long as a specified condition is true. 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.

TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

Devuelve los elementos de una secuencia en tanto que el valor de una condición especificada sea true.Returns elements from a sequence as long as a specified condition is true.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ TakeWhile(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, bool> ^> ^ predicate);
public static System.Linq.IQueryable<TSource> TakeWhile<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);
static member TakeWhile : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> System.Linq.IQueryable<'Source>
<Extension()>
Public Function TakeWhile(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As IQueryable(Of TSource)

Parámetros de tipo

TSource

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

Parámetros

source
IQueryable<TSource>

Secuencia cuyos elementos se van a devolver.The sequence to return elements from.

predicate
Expression<Func<TSource,Boolean>>

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

Devoluciones

IQueryable<TSource>

IQueryable<T> que contiene los elementos de la secuencia de entrada que se encuentran antes del elemento en el que la prueba especificada predicate no se realiza correctamente.An IQueryable<T> that contains elements from the input sequence occurring before the element at which the test specified by predicate no longer passes.

Excepciones

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) para devolver elementos desde el inicio de una secuencia siempre que se cumpla una condición.The following code example demonstrates how to use TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) to return elements from the start of a sequence as long as a condition is true.

string[] fruits = { "apple", "banana", "mango", "orange",
                      "passionfruit", "grape" };

// Take strings from the array until a string
// that is equal to "orange" is found.
IEnumerable<string> query =
    fruits.AsQueryable()
    .TakeWhile(fruit => String.Compare("orange", fruit, true) != 0);

foreach (string fruit in query)
    Console.WriteLine(fruit);

/*
    This code produces the following output:

    apple
    banana
    mango
*/
Dim fruits() As String = {"apple", "banana", "mango", "orange", _
                      "passionfruit", "grape"}

' Take strings from the array until a string
' that is equal to "orange" is found.
Dim query = fruits.AsQueryable() _
    .TakeWhile(Function(fruit) String.Compare("orange", fruit, True) <> 0)

Dim output As New System.Text.StringBuilder
For Each fruit As String In query
    output.AppendLine(fruit)
Next

' Display the output.
MsgBox(output.ToString())

'This code produces the following output:

'apple
'banana
'mango

Comentarios

Este método tiene al menos un parámetro de tipo Expression<TDelegate> cuyo argumento de tipo es uno de los Func<T,TResult> tipos.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Para estos parámetros, puede pasar una expresión lambda y se compilará en un Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

El TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) método genera un MethodCallExpression que representa la llamada a TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) sí mismo como un método genérico construido.The TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) method generates a MethodCallExpression that represents calling TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) itself as a constructed generic method. A continuación, pasa el MethodCallExpression al CreateQuery(Expression) método de IQueryProvider representado por la Provider propiedad del source parámetro.It then passes the MethodCallExpression to the CreateQuery(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) la llamada depende de la implementación del tipo del source parámetro.The query behavior that occurs as a result of executing an expression tree that represents calling TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) depends on the implementation of the type of the source parameter. El comportamiento esperado es que se aplica predicate a cada elemento de source hasta que encuentra un elemento para el que predicate devuelve false .The expected behavior is that it applies predicate to each element in source until it finds an element for which predicate returns false. Devuelve todos los elementos hasta ese punto.It returns all the elements up until that point.

Se aplica a

TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>)

Devuelve los elementos de una secuencia en tanto que el valor de una condición especificada sea true.Returns elements from a sequence as long as a specified condition is true. 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::Linq::IQueryable<TSource> ^ TakeWhile(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, int, bool> ^> ^ predicate);
public static System.Linq.IQueryable<TSource> TakeWhile<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,int,bool>> predicate);
static member TakeWhile : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, int, bool>> -> System.Linq.IQueryable<'Source>
<Extension()>
Public Function TakeWhile(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Integer, Boolean))) As IQueryable(Of TSource)

Parámetros de tipo

TSource

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

Parámetros

source
IQueryable<TSource>

Secuencia cuyos elementos se van a devolver.The sequence to return elements from.

predicate
Expression<Func<TSource,Int32,Boolean>>

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

Devoluciones

IQueryable<TSource>

IQueryable<T> que contiene los elementos de la secuencia de entrada que se encuentran antes del elemento en el que la prueba especificada predicate no se realiza correctamente.An IQueryable<T> that contains elements from the input sequence occurring before the element at which the test specified by predicate no longer passes.

Excepciones

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) para devolver elementos desde el inicio de una secuencia siempre que una condición que use el índice del elemento sea true.The following code example demonstrates how to use TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) to return elements from the start of a sequence as long as a condition that uses the index of the element is true.

string[] fruits = { "apple", "passionfruit", "banana", "mango",
                      "orange", "blueberry", "grape", "strawberry" };

// Take strings from the array until a string whose length
// is less than its index in the array is found.
IEnumerable<string> query =
    fruits.AsQueryable()
    .TakeWhile((fruit, index) => fruit.Length >= index);

foreach (string fruit in query)
    Console.WriteLine(fruit);

/*
    This code produces the following output:

    apple
    passionfruit
    banana
    mango
    orange
    blueberry
*/
Dim fruits() As String = _
    {"apple", "passionfruit", "banana", "mango", _
     "orange", "blueberry", "grape", "strawberry"}

' Take strings from the array until a string whose length
' is less than its index in the array is found.
Dim query = fruits.AsQueryable() _
    .TakeWhile(Function(fruit, index) fruit.Length >= index)

' Display the results.
Dim output As New System.Text.StringBuilder
For Each fruit As String In query
    output.AppendLine(fruit)
Next
MsgBox(output.ToString())

' This code produces the following output:

' apple
' passionfruit
' banana
' mango
' orange
' blueberry

Comentarios

Este método tiene al menos un parámetro de tipo Expression<TDelegate> cuyo argumento de tipo es uno de los Func<T,TResult> tipos.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Para estos parámetros, puede pasar una expresión lambda y se compilará en un Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

El TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) método genera un MethodCallExpression que representa la llamada a TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) sí mismo como un método genérico construido.The TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) method generates a MethodCallExpression that represents calling TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) itself as a constructed generic method. A continuación, pasa el MethodCallExpression al CreateQuery(Expression) método de IQueryProvider representado por la Provider propiedad del source parámetro.It then passes the MethodCallExpression to the CreateQuery(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) la llamada depende de la implementación del tipo del source parámetro.The query behavior that occurs as a result of executing an expression tree that represents calling TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) depends on the implementation of the type of the source parameter. El comportamiento esperado es que se aplica predicate a cada elemento de source hasta que encuentra un elemento para el que predicate devuelve false .The expected behavior is that it applies predicate to each element in source until it finds an element for which predicate returns false. Devuelve todos los elementos hasta ese punto.It returns all the elements up until that point. El índice de cada elemento de origen se proporciona como el segundo argumento de predicate .The index of each source element is provided as the second argument to predicate.

Se aplica a