Reset (método) (RDS)

Ejecuta el criterio de ordenación o filtro en un objeto Conjunto de registros del lado cliente en función de las propiedades de filtro y ordenación especificadas.

Importante

A partir de Windows 8 y Windows Server 2012, los componentes del servidor RDS ya no se incluyen en el sistema operativo Windows (para obtener más información, consulte Windows 8 y la Guía de compatibilidad de Windows Server 2012, edición Cookbook). Los componentes de cliente de RDS se eliminarán en una versión futura de Windows. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Las aplicaciones que usan RDS deben migrar al servicio de datos WCF.

Sintaxis

  
DataControl.Reset(value)  

Parámetros

DataControl
Una variable de objeto que representa un objeto RDS.DataControl.

value
Opcional. Un valor Booleano que es True (valor predeterminado) si quiere filtrar por el conjunto de filas "filtrado" actual. False indica que se filtra por el conjunto de filas original y quita cualquier opción de filtro anterior.

Comentarios

Las propiedades SortColumn, SortDirection, FilterValue, FilterCriterion y FilterColumn proporcionan funcionalidad de ordenación y filtrado en la memoria caché del lado cliente. La funcionalidad de organización ordena los registros por los valores de una columna. La funcionalidad de filtrado muestra un subconjunto de registros en función de los criterios de búsqueda, mientras que el Conjunto de registros completo se mantiene en la memoria caché. El método Reset ejecutará los criterios y reemplazará el actual Conjunto de registros por un Conjunto de registros actualizable.

Si hay cambios en los datos originales que no se han enviado, se producirá un error en el método Reset. En primer lugar, use el método SubmitChanges para guardar los cambios en un Conjunto de registros de lectura y escritura y, a continuación, use el método Conjunto de registros para ordenar o filtrar los registros.

Si desea realizar más de un filtro en el conjunto de filas, puede usar el argumento opcional Booleano con el método Reset. El ejemplo siguiente muestra cómo hacerlo:

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

Se aplica a

Objeto DataControl (RDS)

Consulte también

Propiedades FilterColumn, FilterCriterion, FilterValue, SortColumn, SortDirection y ejemplo del método Reset (VBScript)
Método SubmitChanges (RDS)