Método Reset (RDS)

Artículo
01/19/2017

Ejecuta el criterio de ordenación o filtro en un objeto Recordset de 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 (consulte Windows 8 y Guía de compatibilidad de Windows Server 2012 para obtener más detalles). Los componentes de cliente de RDS se quitarán en una versión futura de Windows. Evite usar esta característica en el nuevo trabajo de desarrollo y planee modificar las aplicaciones que actualmente usan esta característica. Las aplicaciones que usan RDS deben migrar a servicio de datos WCF.

Sintaxis

  
DataControl.Reset(value)

Parámetros

DataControl
Variable de objeto que representa un RDS. DataControl objeto.

de valor de
Opcional. Valor de booleano que es True (valor predeterminado) si desea filtrar en el conjunto de filas "filtrado" actual. False indica que se filtra en el conjunto de filas original, quitando las opciones de filtro anteriores.

Observaciones

Las propiedades SortColumn, SortDirection, FilterValue, FilterCriteriony FilterColumn proporcionan funcionalidad de ordenación y filtrado en la caché del lado cliente. La funcionalidad de ordenación ordena los registros por 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 de ejecutará los criterios y reemplazará el recordset de actual por un objeto Recordset 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 Recordset de lectura y escrituray, a continuación, use el método Reset para ordenar o filtrar los registros.

Si desea realizar más de un filtro en el conjunto de filas, puede usar el argumento booleano opcional con el método Reset. En el ejemplo siguiente se 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 y SortDirection y Ejemplo de método Reset (VBScript)
método SubmitChanges (RDS)

Compartir vía