Método ConvertToString (RDS)

Convierte un objeto Recordset en una cadena MIME que representa los datos del conjunto de registros.

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

  
DataFactory.ConvertToString(Recordset)  

Parámetros

DataFactory
Variable de objeto que representa un objeto RDSServer.DataFactory.

Recordset
Variable de objeto que representa un objeto Recordset.

Comentarios

Con los archivos .asp, use ConvertToString para insertar el objeto Recordset en una página HTML generada en el servidor para transportarlo a un equipo cliente.

ConvertToString carga primero el objeto Recordset en las tablas del Servicio de cursores y, a continuación, genera una secuencia en formato MIME.

En el cliente, el servicio de datos remotos puede volver a convertir la cadena MIME en un Recordset totalmente funcional. Funciona bien para controlar menos de 400 filas de datos sin más de 1024 bytes de ancho por fila. No debe usarlo para transmitir datos BLOB y conjuntos de resultados grandes a través de HTTP. No se realiza ninguna compresión de cables en la cadena, por lo que los conjuntos de datos muy grandes tardarán mucho tiempo en transportarse a través de HTTP en comparación con el formato de tablegrama optimizado para conexión definido e implementado por Remote Data Service como su formato de protocolo de transporte nativo.

Nota

Si usa Active Server Pages para insertar la cadena MIME resultante en una página HTML de cliente, tenga en cuenta que las versiones de VBScript anteriores a la versión 2.0 limitan el tamaño de la cadena a 32 K. Si se supera este límite, se devuelve un error. Mantenga el ámbito de consulta relativamente pequeño al usar la inserción de MIME a través de archivos .asp. Para corregirlo, descargue la versión más reciente de VBScript desde el sitio web de Microsoft Windows Script Technologies.

Se aplica a

Objeto DataFactory (RDSServer)

Consulte también

Ejemplo del método ConvertToString (VB)
Ejemplo del método ConvertToString (VBScript)