Propriedade Sort (ADO)

Aplica-se ao: Access 2013, Office 2013

Indica um ou mais nomes de campo nos quais o Recordset é classificado e se cada campo é classificado na ordem crescente ou decrescente.

Configurações e valores retornados

Define ou retorna um valor String que indica os nomes dos campos do Recordset no qual classificá-los. Cada nome é separado por uma vírgula e é, opcionalmente, seguido por um espaço em branco e pela palavra-chave, ASC, que classifica o campo na ordem crescente ou DESC, que classifica o campo na ordem decrescente. Por padrão, se nenhuma palavra-chave for especificada, o campo será classificado na ordem crescente.

Comentários

Essa propriedade exige que a propriedade CursorLocation seja definida como adUseClient. Se ainda não existir um índice, será criado um temporário para cada campo especificado na propriedade Sort.

A operação de classificação é eficiente, pois os dados não são reorganizados fisicamente, mas simplesmente acessados na ordem especificada pelo índice.

A definição da propriedade Sort em uma sequência de caracteres vazia redefinirá as linhas para sua ordem original e excluirá os índices temporários. Os índices existentes não serão excluídos.

Suponha que um Recordset contenha três campos denominados firstName, middleInitial e lastName. Defina a propriedade Sort como a cadeia de caracteres " lastName DESC, firstName ASC", que ordenará o Recordset por sobrenome em ordem decrescente e, em seguida, pelo primeiro nome em ordem crescente. A inicial do segundo nome será ignorada.

Nenhum campo poderá ser nomeado como "ASC" ou "DESC", pois esses nomes entrariam em conflito com as palavras-chave ASC e DESC. Forneça um alias ao campo com um nome conflitante utilizando a palavra-chave AS na consulta que retornar o Recordset.