Reset, méthode (RDS)

Article
05/30/2023

Exécute le tri ou le filtre sur un objet Recordset côté client, en fonction des propriétés de tri et de filtre spécifiées.

Important

À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir le Guide pratique sur la compatibilité de Windows Server 2012 et Windows 8 pour plus de détails). Les composants clients RDS seront supprimés dans une version ultérieure de Windows. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers WCF Data Service.

Syntaxe

  
DataControl.Reset(value)

Paramètres

DataControl
Variable d’objet qui représente un objet RDS.DataControl.

value
facultatif. Valeur booléennetrue (valeur par défaut) si vous souhaitez filtrer sur l’ensemble de lignes « filtré » actuel. False indique que vous filtrez sur l’ensemble de lignes d’origine, en supprimant toutes les options de filtre précédentes.

Notes

Les propriétés SortColumn, SortDirection, FilterValue, FilterCriterion et FilterColumn fournissent des fonctionnalités de tri et de filtrage sur le cache côté client. La fonctionnalité de tri commande les enregistrements par valeurs d’une colonne. La fonctionnalité de filtrage affiche un sous-ensemble d’enregistrements en fonction des critères de recherche, tandis que l’objet Recordset complet est conservé dans le cache. La méthode Reset exécute les critères et remplace l’objet Recordset actif par un Recordset pouvant être mis à jour.

S’il existe des modifications apportées aux données d’origine qui n’ont pas été envoyées, la méthode Reset échoue. Tout d’abord, utilisez la méthode SubmitChanges pour enregistrer les modifications apportées à un Recordset en lecture/écriture, puis utilisez la méthode Reset pour trier ou filtrer les enregistrements.

Si vous souhaitez effectuer plusieurs filtres sur votre ensemble de lignes, vous pouvez utiliser l’argument booléen facultatif avec la méthode Reset . L’exemple suivant vous montre comment procéder :

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

S'applique à

DataControl, objet (RDS)

Voir aussi

Exemple de propriétés FilterColumn, FilterCriterion, FilterValue, SortColumn et SortDirection, et de méthode Reset (VBScript)
SubmitChanges, méthode (RDS)

Partager via