Compartilhar via


Método reset (RDS)

Aplica-se ao: Access 2013, Office 2013

Executa a classificação ou a filtragem em um Recordset de cliente, com base nas propriedades de classificação e filtragem especificadas.

Sintaxe

DataControl. Redefinir(valor)

Parâmetros

Parâmetro Descrição
DataControl Uma variável de objeto que representa um objeto RDS.DataControl.
value Opcional. Um valor Boolean que é True (padrão) se você deseja filtrar pelo conjunto de linhas "filtrado" atual. False indica que você filtra pelo conjunto de linhas original, removendo quaisquer opções de filtro anteriores.

Comentários

As propriedades SortColumn, SortDirection, FilterValue, FilterCriterion e FilterColumn fornecem funcionalidade de classificação e filtragem no cache do lado do cliente. A funcionalidade de classificação ordena os registros pelos valores de uma coluna. A funcionalidade de filtro exibe um subconjunto de registros com base em critérios de localização, enquanto o Recordset completo é mantido no cache. O método Reset irá executar os critérios e substituir o Recordset atual por um Recordset atualizável.

Se houver alterações nos dados originais que ainda não foram submetidas, o método Reset falhará. Primeiro, utilize o método SubmitChanges para salvar quaisquer alterações em um Recordset de leitura/gravação e, em seguida, utilize o método Reset para classificar ou filtrar os registros.

Se você deseja executar mais de um filtro em seu conjunto de linhas, poderá utilizar o argumento opcional Boolean com o método Reset. O exemplo a seguir mostra como fazer isso: