Método ConvertToString (RDS)

Converte um conjunto de registros em uma cadeia de caracteres MIME que representa os dados do conjunto de registros.

Importante

A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (consulte o Windows 8 e o Windows Server 2012 Compatibility Cookbook para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Os aplicativos que usam RDS devem migrar para WCF Data Service.

Sintaxe

  
DataFactory.ConvertToString(Recordset)  

Parâmetros

datafactory
Uma variável de objeto que representa um objeto RDSServer.DataFactory.

do conjunto de registros
Uma variável de objeto que representa um objeto Recordset.

Observações

Com arquivos .asp, use ConvertToString para inserir o conjunto de registros em uma página HTML gerada no servidor para transportá-lo para um computador cliente.

ConvertToString primeiro carrega o Recordset nas tabelas do Serviço de Cursor e, em seguida, gera um fluxo no formato MIME.

No cliente, o Serviço de Dados Remotos pode converter a cadeia de caracteres MIME novamente em um conjunto de registros totalmente funcional. Ele funciona bem para lidar com menos de 400 linhas de dados com no máximo 1024 bytes de largura por linha. Você não deve usá-lo para transmitir dados BLOB e grandes conjuntos de resultados por HTTP. Nenhuma compactação de fio é executada na cadeia de caracteres, portanto, conjuntos de dados muito grandes levarão tempo considerável para serem transportados por HTTP quando comparados ao formato de tablegram com otimização de fio definido e implantado pelo Serviço de Dados Remotos como seu formato de protocolo de transporte nativo.

Nota

Se você estiver usando Páginas do Servidor Ativo para inserir a cadeia de caracteres MIME resultante em uma página HTML do cliente, lembre-se de que as versões do VBScript anteriores à versão 2.0 limitam o tamanho da cadeia de caracteres para 32K. Se esse limite for excedido, um erro será retornado. Mantenha o escopo da consulta relativamente pequeno ao usar a inserção MIME por meio de arquivos .asp. Para corrigir isso, baixe a versão mais recente do VBScript no site da Microsoft Windows Script Technologies.

Aplica-se a

objeto DataFactory (RDSServer)

Consulte Também

Exemplo do método ConvertToString (VB)
Exemplo do método ConvertToString (VBScript)