Reset-Methode (RDS)

Artikel
01/19/2017

Führt die Sortierung oder den Filter auf einer 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 Details finden Sie unter Windows 8 und Windows Server 2012 Compatibility Cookbook). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Vermeiden Sie die Verwendung dieses Features in neuer Entwicklungsarbeit, und planen Sie, Anwendungen zu ändern, die derzeit dieses Feature verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Servicemigrieren.

Syntax

  
DataControl.Reset(value)

Parameter

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

Wert
Wahlfrei. 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 SortColumn, SortDirection, FilterValue, FilterCriterionund FilterColumn Eigenschaften 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 methode Reset führt die Kriterien aus und ersetzt das aktuelle Recordset- durch ein aktualisierbares Recordset-.

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

Wenn Sie mehrere Filter für Das Rowset ausführen möchten, können Sie das optionale boolesche Argument mit der Reset-Methode verwenden. Das folgende Beispiel zeigt, wie Dies geschieht:

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)

Siehe auch

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

Freigeben über