Queryable.TakeWhile Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve elementos de uma sequência desde que uma condição especificada seja verdadeira, e depois ignora os elementos restantes.
Sobrecargas
| Name | Description |
|---|---|
| TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) |
Devolve elementos de uma sequência desde que uma condição especificada seja verdadeira. O índice do elemento é usado na lógica da função de predicado. |
| TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) |
Devolve elementos de uma sequência desde que uma condição especificada seja verdadeira. |
TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>)
Devolve elementos de uma sequência desde que uma condição especificada seja verdadeira. O índice do elemento é usado na lógica da função de predicado.
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 Genérico
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IQueryable<TSource>
A sequência para devolver elementos de.
- predicate
- Expression<Func<TSource,Int32,Boolean>>
Uma função para testar cada elemento para uma condição; O segundo parâmetro da função representa o índice do elemento na sequência de origem.
Devoluções
Um IQueryable<T> que contém elementos da sequência de entrada que ocorrem antes do elemento em que o teste especificado por predicate já não passa.
Exceções
source ou predicate é null.
Exemplos
O exemplo de código seguinte demonstra como usar TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) para devolver elementos desde o início de uma sequência, desde que uma condição que use o índice do elemento seja verdadeira.
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
Observações
Este método tem pelo menos um parâmetro de tipo Expression<TDelegate> cujo argumento de tipo é um dos Func<T,TResult> tipos. Para estes parâmetros, pode-se passar uma expressão lambda e ela será compilada para um Expression<TDelegate>.
O TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) método gera um MethodCallExpression que representa o autodenominado TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) como um método genérico construído. Depois passa o MethodCallExpression para o CreateQuery(Expression) método de o IQueryProvider representado pela Provider propriedade do source parâmetro.
O comportamento de consulta que ocorre como resultado da execução de uma árvore de expressões que representa a chamada TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) depende da implementação do tipo do source parâmetro. O comportamento esperado é que se aplique predicate a cada elemento em source até encontrar um elemento para o qual predicate retorne false. Devolve todos os elementos até esse ponto. O índice de cada elemento fonte é fornecido como segundo argumento para predicate.
Aplica-se a
TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)
Devolve elementos de uma sequência desde que uma condição especificada seja verdadeira.
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 Genérico
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IQueryable<TSource>
A sequência para devolver elementos de.
- predicate
- Expression<Func<TSource,Boolean>>
Uma função para testar cada elemento para uma condição.
Devoluções
Um IQueryable<T> que contém elementos da sequência de entrada que ocorrem antes do elemento em que o teste especificado por predicate já não passa.
Exceções
source ou predicate é null.
Exemplos
O exemplo de código seguinte demonstra como usar TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) para devolver elementos do início de uma sequência, desde que uma condição seja verdadeira.
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
Observações
Este método tem pelo menos um parâmetro de tipo Expression<TDelegate> cujo argumento de tipo é um dos Func<T,TResult> tipos. Para estes parâmetros, pode-se passar uma expressão lambda e ela será compilada para um Expression<TDelegate>.
O TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) método gera um MethodCallExpression que representa o autodenominado TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) como um método genérico construído. Depois passa o MethodCallExpression para o CreateQuery(Expression) método de o IQueryProvider representado pela Provider propriedade do source parâmetro.
O comportamento de consulta que ocorre como resultado da execução de uma árvore de expressões que representa a chamada TakeWhile<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) depende da implementação do tipo do source parâmetro. O comportamento esperado é que se aplique predicate a cada elemento em source até encontrar um elemento para o qual predicate retorne false. Devolve todos os elementos até esse ponto.