Método ConvertToString (RDS)
Converte um Recordset 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 (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.
Sintaxe
DataFactory.ConvertToString(Recordset)
Parâmetros
DataFactory
Uma variável de objeto que representa um objeto RDSServer.DataFactory.
Recordset
Uma variável de objeto que representa um objeto Recordset.
Comentários
Com arquivos .asp, use ConvertToString para inserir o Recordset em uma página HTML gerada no servidor a fim de transportá-lo para um computador cliente.
ConvertToString primeiro carrega o Recordset nas tabelas do Cursor Service e, em seguida, gera um fluxo no formato MIME.
No cliente, o Remote Data Service pode converter a cadeia de caracteres MIME novamente em um Recordset totalmente funcional. Ele funciona bem para lidar com menos de 400 linhas de dados de não mais de 1024 bytes de largura por linha. Você não deve usá-lo para transmitir dados de BLOB e conjuntos de resultados grandes sobre HTTP. Nenhuma compactação eletrônica é executada na cadeia de caracteres, ou seja, conjuntos de dados muito grandes levarão um tempo considerável para serem carregados sobre HTTP quando comparados com o formato de tablegram com otimização de cabo definido e implantado pelo Remote Data Service como seu formato de protocolo de transporte nativo.
Observação
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 a 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 do site do 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)