Método Reset (RDS)

Artigo
01/19/2017

Executa a classificação ou o filtro em uma do conjunto de registros do lado do cliente com base nas propriedades de classificação e 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 (consulte o Windows 8 e o Windows Server 2012 Compatibility Cookbook para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Os aplicativos que usam RDS devem migrar para WCF Data Service.

Sintaxe

  
DataControl.Reset(value)

Parâmetros

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

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

Observações

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

Se houver alterações nos dados originais que não foram enviados, o método Redefinir falhará. Primeiro, use o método SubmitChanges para salvar as alterações em um conjunto de registros 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 booliano opcional com o método Redefinir. 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

filterColumn, FilterCriterion, FilterValue, SortColumn e SortDirection Properties and Reset Method Example (VBScript)
método SubmitChanges (RDS)

Partilhar via