Compartilhar via


Ignorar cláusula While (Visual Basic)

Ignora elementos numa coleção enquanto a condição especificada é true e então retorna os elementos restantes.

Skip While expression

Partes

Termo

Definição

expression

Obrigatório. Uma expressão que representa uma condição para a qual para testar elementos. A expressão deve retornar um valor Boolean ou um funcional equivalente, como um Integer para ser avaliado como um Boolean.

Comentários

A cláusula Skip While ignora elementos do começo do resultado de uma consulta até que a expression fornecida retorne false. Depois que o parâmetro expression retorna false, a consulta retorna todos os elementos restantes. A expression é ignorada para os resultados restantes.

A cláusula Skip While difere da clásula Where no momento em que a cláusula Where pode ser usada para excluir todos os elementos de uma consulta, enquanto a outra não se adequa à essa condição particular. A cláusula Skip While excluir elementos apenas até que a condição não é satisfeita pela primeira vez. A cláusula Skip While é útil quando você está trabalhando com um resultado de consulta ordenado.

Você pode ignorar um número específico de resultados desde o começo de uma consulta usando a cláusula Skip.

Exemplo

O seguinte exemplo de código usa a cláusula Skip While para ignorar resultados até que o primeiro cliente dos Estados Unidos é encontrado.

Public Sub SkipWhileSample()
  Dim customers = GetCustomerList()

  ' Return customers starting from the first U.S. customer encountered. 
  Dim customerList = From cust In customers
                     Order By cust.Country
                     Skip While IsInternationalCustomer(cust)

  For Each cust In customerList
    Console.WriteLine(cust.CompanyName & vbTab & cust.Country)
  Next 
End Sub 

Public Function IsInternationalCustomer(ByVal cust As Customer) As Boolean 
  If cust.Country = "USA" Then Return False 

  Return True 
End Function

Consulte também

Referência

Cláusula Select (Visual Basic)

Cláusula From (Visual Basic)

Cláusula Skip (Visual Basic)

Cláusula Take While (Visual Basic)

Cláusula Where (Visual Basic)

Conceitos

Introdução a LINQ no Visual Basic

Outros recursos

Consultas (Visual Basic)