Reset, méthode (RDS)

Article
01/19/2017

Exécute le tri ou le filtre sur un jeu d’enregistrements 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 Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail 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 RDS. Objet dataControl.

valeur
Optionnel. Valeur de 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 les options de filtre précédentes.

Remarques

Le SortColumn, sortDirection, FilterValue, FilterCriterionet propriétés filterColumn fournissent des fonctionnalités de tri et de filtrage sur le cache côté client. La fonctionnalité de tri tri trie les enregistrements par valeurs d’une colonne. La fonctionnalité de filtrage affiche un sous-ensemble d’enregistrements en fonction d’un critère de recherche, tandis que le jeu d’enregistrements complet est conservé dans le cache. La méthode Reset exécute les critères et remplace le jeu d’enregistrements actuel par un jeu d’enregistrements 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 Réinitialiser échoue. Tout d’abord, utilisez la méthode SubmitChanges pour enregistrer les modifications apportées à un jeu d’enregistrements en lecture/écriture , puis utilisez la méthode Réinitialiser 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 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

FilterColumn, FilterCriterion, FilterValue, SortColumn et SortDirection Properties and Reset, Method Example (VBScript)
Méthode SubmitChanges (RDS)

Partager via