Метод Reset (служба удаленных рабочих столов)

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

Важно!

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

Синтаксис

  
DataControl.Reset(value)  

Параметры

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

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

Комментарии

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

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

Если вы хотите выполнить несколько фильтров для набора строк, можно использовать необязательный логический аргумент с методом 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 (служба удаленных рабочих столов)

См. также:

FilterColumn, FilterCriterion, FilterValue, SortColumn и SortDirection Properties and Reset Method Example (VBScript)
Метод SubmitChanges (служба удаленных рабочих столов)