método Guardar

Guarda el Recordset en un archivo o objeto stream.

Sintaxis

  
recordset.Save Destination, PersistFormat  

Parámetros

Destino
Opcional. Variant que representa el nombre de ruta de acceso completa del archivo donde se va a guardar el objeto Recordset o una referencia a un objeto Stream.

PersistFormat
Opcional. Valor PersistFormatEnum que especifica el formato en el que se va a guardar el objeto Recordset (XML o ADTG). El valor predeterminado es adPersistADTG.

Observaciones

El método Save Method solo se puede invocar en un objeto Recordset abierto. Use el método Open Method (Recordset de ADO) para restaurar posteriormente el objeto Recordset desde Destination.

Si la propiedad Filter Property está en vigor para el objeto Recordset, solo se guardan las filas accesibles bajo el filtro. Si el objeto Recordset es jerárquico, el objeto Recordset secundario actual y sus elementos secundarios se guardan, incluido el objeto Recordset primario. Si se llama al método Save de un objeto Recordset secundario, se guardan el elemento secundario y todos sus elementos secundarios, pero el elemento primario no lo es.

La primera vez que guarda el Recordset, es opcional especificar Destino. Si omite Destination, se creará un nuevo archivo con un nombre establecido en el valor de la propiedad Source del objeto Recordset.

Omita Destination cuando llame posteriormente a Save después del primer guardado o se producirá un error en tiempo de ejecución. Si posteriormente llama a Save con un nuevo Destination, se guarda el Recordset en la nueva ubicación. Sin embargo, el nuevo destino y el destino original estarán abiertos.

Guardar no cierra el Recordset o el Destination, por lo que puede seguir trabajando con el Recordset y guardar sus cambios más recientes. El destino permanece abierto hasta que se cierre el objeto Recordset .

Por motivos de seguridad, el método Save permite solo el uso de la configuración de seguridad baja y personalizada desde un script ejecutado por Microsoft Internet Explorer.

Si se llama al método Save mientras está en curso una operación asincrónica de captura, ejecución o actualización del objeto Recordset , Guardar espera hasta que se complete la operación asincrónica.

Los registros se guardan a partir de la primera fila del conjunto de registros de . Cuando finaliza el método Save, la posición de fila actual se mueve a la primera fila del Recordset.

Para obtener los mejores resultados, establezca la propiedad CursorLocation Property (ADO) en adUseClient con Save. Si el proveedor no admite toda la funcionalidad necesaria para guardar objetos Recordset, el Servicio de Cursor proporcionará esa funcionalidad.

Cuando un Recordset se conserva con la propiedad CursorLocation establecida en adUseServer, la capacidad de actualización para el Recordset es limitada. Normalmente, solo se permiten actualizaciones, inserciones e eliminaciones de una sola tabla (dependen de la funcionalidad del proveedor). El método Resync Method tampoco está disponible en esta configuración.

Solo los filtros en forma de cadenas de criterios (por ejemplo, OrderDate > '12/31/1999') afectan al contenido de un objeto Recordset persistente. Los filtros creados con una matriz de marcadores o el uso de un valor de FilterGroupEnum no afectarán al contenido del objeto Recordset persistente. Estas reglas se aplican a los conjuntos de registroscreados con cursores del lado cliente o del lado servidor.

Dado que el parámetro Destination puede aceptar cualquier objeto que admita la interfaz IStream de OLE DB, puede guardar un objeto Recordset directamente en el objeto ASP Response. Para obtener más información, consulte el escenario de persistencia del conjunto de registros XML.

También puede guardar un objeto Recordset en formato XML en una instancia de un objeto DOM MSXML, como se muestra en el siguiente código de Visual Basic:

Dim xDOM As New MSXML.DOMDocument  
Dim rsXML As New ADODB.Recordset  
Dim sSQL As String, sConn As String  
  
sSQL = "SELECT customerid, companyname, contactname FROM customers"  
sConn="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=Northwind.mdb"  
rsXML.Open sSQL, sConn  
rsXML.Save xDOM, adPersistXML   'Save Recordset directly into a DOM tree.  
...  

Un objeto Recordset guardado en formato XML se guarda con formato UTF-8. Cuando este archivo se carga en una secuencia de ADO, el objeto Stream no intentará abrir un objeto Recordset desde la secuencia a menos que la propiedad Charset de la secuencia esté establecida en el valor adecuado para el formato UTF-8.

Se aplica a

Véase también

Ejemplo de métodos Save y Open (VB)
Ejemplo de métodos Save y Open (VC++)
Método Open (Recordset de ADO)
open (secuencia de ADO)
del método SaveToFile de