Metodo Reset (Servizi Desktop remoto)

  • Articolo

Esegue l'ordinamento o il filtro in un Recordset lato client, in base alle proprietà di ordinamento e filtro specificate.

Importante

A partire da Windows 8 e Windows Server 2012, i componenti del server di RDS non sono più inclusi nel sistema operativo Windows. Per altri dettagli, vedere la Guida di riferimento per la compatibilità di Windows 8 e Windows Server 2012. I componenti del client di RDS verranno rimossi in una versione futura di Windows. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Le applicazioni che usano RDS devono eseguire la migrazione a WCF Data Service.

Sintassi

  
DataControl.Reset(value)

Parametri

DataControl
Variabile oggetto che rappresenta un oggetto RDS.DataControl.

value
facoltativo. Valore booleano impostato su true (impostazione predefinita) se si vuole filtrare in base al set di righe "filtrato" corrente. False indica che il filtro viene applicato al set di righe originale, rimuovendo le opzioni di filtro precedenti.

Osservazioni

Le proprietà SortColumn, SortDirection, FilterValue, FilterCriterion e FilterColumn forniscono funzionalità di ordinamento e filtro nella cache lato client. La funzionalità di ordinamento ordina i record in base ai valori di una colonna. La funzionalità di filtro visualizza un subset di record in base ai criteri di ricerca, mentre l'oggetto Recordset completo viene mantenuto nella cache. Il metodo Reset eseguirà i criteri e sostituirà l'oggetto Recordset corrente con un oggetto Recordset aggiornabile.

Se sono state apportate modifiche ai dati originali che non sono state inviate, il metodo Reset avrà esito negativo. Usare innanzitutto il metodo SubmitChanges per salvare le modifiche in un oggetto Recordset di lettura/scrittura, quindi usare il metodo Reset per ordinare o filtrare i record.

Per applicare più di un filtro al set di righe, è possibile usare l'argomento Boolean facoltativo con il metodo Reset. L'esempio seguente illustra come farlo:

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".

Si applica a

Oggetto DataControl (Servizi Desktop remoto)

Vedere anche

Esempio delle proprietà FilterColumn, FilterCriterion, FilterValue, SortColumn e SortDirection e del metodo Reset (VBScript)
Metodo SubmitChanges (Servizi Desktop remoto)