Compartilhar via


Cláusula Skip While (Visual Basic)

Ignora elementos em uma coleção, desde que uma condição especificada seja true e, em seguida, retorna os elementos restantes.

Sintaxe

Skip While expression  

Partes

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

Observações

A Skip While cláusula ignora elementos do início de um resultado de consulta até que o fornecido expression retorne false. Após expression o retorno false, a consulta retorna todos os elementos restantes. O expression é ignorado para os resultados restantes.

A Skip While cláusula difere da Where cláusula na qual a Where cláusula pode ser usada para excluir todos os elementos de uma consulta que não atenda a uma condição específica. A Skip While cláusula exclui elementos somente até a primeira vez que a condição não for atendida. A Skip While cláusula é mais útil quando você está trabalhando com um resultado de consulta ordenado.

Você pode ignorar um número específico de resultados desde o início de um resultado de consulta usando a Skip cláusula.

Exemplo

O exemplo de código a seguir usa a Skip While cláusula para ignorar os resultados até que o primeiro cliente dos Estados Unidos seja 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