Метод сброса (RDS)

Выполняет сортировку или фильтрацию в наборе записей на стороне клиента на основе указанных свойств сортировки и фильтрации.

Это важно

Начиная с Windows 8 и Windows Server 2012, компоненты сервера RDS больше не включены в операционную систему Windows (дополнительные сведения см. в статье Windows 8 и Windows Server 2012 Compatibility Cookbook). Клиентские компоненты RDS будут удалены в будущей версии Windows. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Приложения, использующие RDS, должны мигрировать в WCF Data Service.

Синтаксис

  
DataControl.Reset(value)

Параметры

DataControl
Переменная объекта, представляющая RDS. Объект DataControl.

значение
Необязательно. Логическое значение, которое имеет значение True (по умолчанию), если вы хотите отфильтровать текущий "отфильтрованный" набор строк. False указывает, что фильтруется исходный набор строк, удаляя все предыдущие параметры фильтра.

Замечания

Свойства SortColumn, SortDirection, FilterValue, FilterCriterion и FilterColumn предоставляют функции сортировки и фильтрации в кэше на стороне клиента. Функции сортировки упорядочивает записи по значениям из одного столбца. Функция фильтрации отображает подмножество записей на основе условий поиска, а полный набор записей сохраняется в кэше. Метод Reset выполнит условия и заменит текущий набор записей обновляемым набором записей.

Если есть изменения в исходных данных, которые не были отправлены, метод Сброса завершится ошибкой. Сначала используйте метод SubmitChanges , чтобы сохранить изменения в наборе записей чтения и записи, а затем использовать метод Сброса для сортировки или фильтрации записей.

Если вы хотите выполнить несколько фильтров в наборе строк, можно использовать необязательный логический аргумент с методом Reset . В следующем примере показано, как это сделать:

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

Применимо к

объект DataControl (RDS)

См. также

FilterColumn, FilterCriterion, FilterValue, SortColumn и SortDirection Properties and Reset Method Example (VBScript)
Метод SubmitChanges (RDS)

  • Last updated on