Propriedade Sort

Indica um ou mais nomes de campos nos quais o Recordset é classificado e se cada campo é classificado em ordem ascendente ou decrescente.

Configurações e valores retornados

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

Comentários

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

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

Quando o valor da propriedade Sort é algo diferente de uma cadeia de caracteres vazia, a ordem de propriedade Sort tem precedência sobre a ordem especificada em uma cláusula ORDER BY incluída na instrução SQL usada para abrir o Recordset.

O Recordset não precisa ser aberto antes de a propriedade Sort ser acessada. Ele pode ser definido a qualquer momento depois que o objeto Recordset é instanciado.

A definição da propriedade Sort como uma cadeia de caracteres vazia redefinirá as linhas para a 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 chamados firstName, middleInitial e lastName. Defina a propriedade Sort como a cadeia de caracteres "lastName DESC, firstName ASC", que ordenará o Recordset pelo sobrenome em ordem decrescente e pelo nome em ordem ascendente. A inicial intermediária é ignorada.

Nenhum campo pode ser chamado de "ASC" ou "DESC" porque esses nomes entram em conflito com as palavras-chave ASC e DESC. Você pode criar um alias para um campo com um nome conflitante usando a palavra-chave AS na consulta que retorna o Recordset.

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo da propriedade Sort (VB)
Exemplo da propriedade Sort (VC++)
Otimizar a propriedade dinâmica (ADO)
Propriedade SortColumn (RDS)
Propriedade SortDirection (RDS)