Compartilhar via


Ignorar cláusula While (Visual Basic)

Ignora elementos em uma coleção, contanto que uma condição especificada seja true e retorne os elementos restantes.

Sintaxe

Skip While expression  

Partes

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

Comentários

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

A cláusula Skip While difere da cláusula Where porque a cláusula Where pode ser usada para excluir todos os elementos de uma consulta que não atendam a uma condição específica. A cláusula Skip While exclui elementos somente até a primeira vez em que a condição não é atendida. A cláusula Skip While é 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 cláusula Skip.

Exemplo

O exemplo de código a seguir usa a cláusula Skip While 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

Confira também