Reset-Methode (RDS)

Artikel
05/30/2023

Führt das Sortieren oder Filtern auf einem clientseitigen Recordset basierend auf den angegebenen Sortier- und Filtereigenschaften aus.

Wichtig

Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.

Syntax

  
DataControl.Reset(value)

Parameter

DataControl
Eine Objektvariable, die ein RDS.DataControl-Objekt darstellt.

value
Optional. Ein boolescher Wert, der True (Standard) ist, wenn Sie nach dem aktuellen „gefilterten“ Rowset filtern möchten. False gibt an, dass Sie nach dem ursprünglichen Rowset filtern und alle vorherigen Filteroptionen entfernen.

Bemerkungen

Die Eigenschaften SortColumn, SortDirection, FilterValue, FilterCriterion und FilterColumn bieten Sortier- und Filterfunktionen im clientseitigen Cache. Die Sortierfunktion sortiert Datensätze nach Werten aus einer Spalte. Die Filterfunktion zeigt eine Teilmenge von Datensätzen basierend auf einem Suchkriterium an, während das vollständige Recordset im Cache verwaltet wird. Die Reset-Methode führt die Kriterien aus und ersetzt das aktuelle Recordset durch ein aktualisierbares Recordset.

Wenn Änderungen an den ursprünglichen Daten vorhanden sind, die nicht übermittelt wurden, schlägt die Reset-Methode fehl. Verwenden Sie zunächst die SubmitChanges-Methode, um Änderungen in einem Recordset mit Lese-/Schreibzugriff zu speichern, und verwenden Sie dann die Reset-Methode, um die Datensätze zu sortieren oder zu filtern.

Wenn Sie mehrere Filter für Ihr Rowset ausführen möchten, können Sie das optionale Boolean-Argument mit der Reset-Methode verwenden. Dies wird anhand des folgenden Beispiels veranschaulicht:

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

Gilt für

DataControl-Objekt (RDS)

Weitere Informationen

FilterColumn-, FilterCriterion-, FilterValue-, SortColumn- und SortDirection-Eigenschaft und Reset-Methode – Beispiel (VBScript)
SubmitChanges-Methode (RDS)

Freigeben über