Partager via


Méthode Reset (RDS)

S’applique à : Access 2013, Office 2013

Applique un tri ou un filtre à un objet Recordset côté client en fonction des propriétés de tri et de filtre spécifiées.

Syntaxe

DataControl. Reset(value)

Paramètres

Paramètre Description
DataControl Une variable objet qui représente un objet RDS.DataControl.
valeur Optional. 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.

Remarques

Les propriétés SortColumn, SortDirection, FilterValue, FilterCriterion et FilterColumn fournissent les fonctionnalités de tri et filtrage sur le cache côté client. La fonctionnalité de tri classe les enregistrements en fonction des valeurs d'une seule colonne. La fonctionnalité de filtre affiche un sous-ensemble d'enregistrements en fonction de certains critères de recherche définis alors 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 objet Recordset qui peut être mis à jour.

Si des modifications apportées aux données d'origine n'ont pas encore été soumises, la méthode Reset échoue. Avant tout, utilisez la méthode SubmitChanges pour enregistrer les éventuelles modifications dans un objet Recordset en lecture/écriture puis employez la méthode Reset pour trier ou filtrer les enregistrements.

Si vous souhaitez exécute plusieurs filtres sur votre ensemble de lignes, vous pouvez utiliser l'argument Boolean facultatif avec la méthode Reset. L'exemple suivant explique comment procéder :