Método Reset (RDS)

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

Importante

A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.

Sintaxe

  
DataControl.Reset(value)  

Parâmetros

DataControl
Uma variável de objeto que representa um objeto RDS.DataControl.

value
Opcional. Um valor Boolean que é True (padrão) se você quiser filtrar no conjunto de linhas "filtrado" atual. False indica que você filtra no conjunto de linhas original, removendo todas as opções de filtro anteriores.

Comentários

As propriedades SortColumn, SortDirection, FilterValue, FilterCriterion e FilterColumn fornecem a 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 filtragem exibe um subconjunto de registros com base em um critério find, enquanto o Recordset completo é mantido no cache. O método Reset executará os critérios e substituirá o Recordset atual por um Recordset atualizável.

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

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

ADC.SQL = "Select au_lname from authors"  
ADC.Refresh    ' Get the new rowset.  
  
ADC.FilterColumn = "au_lname"  
ADC.FilterCriterion = "<"  
ADC.FilterValue = "'M'"  
ADC.Reset         ' Rowset now has all Last Names < "M".  
  
ADC.FilterCriterion = ">"  
ADC.FilterValue = "'F'"  
' Passing True is not necessary, because it is the   
' default filter on the current "filtered" rowset.  
ADC.Reset(TRUE)     ' Rowset now has all Last   
                    ' Names < "M" and > "F".  
  
ADC.FilterCriterion = ">"  
ADC.FilterValue = "'T'"  
' Filter on the original rowset, throwing out the  
' previous filter options.  
ADC.Reset(FALSE)   ' Rowset now has all Last Names > "T".  

Aplica-se A

Objeto DataControl (RDS)

Consulte Também

Propriedades FilterColumn, FilterCriterion, FilterValue, SortColumn e SortDirection e exemplo do método Reset (VBScript)
Método SubmitChanges (RDS)