Método ReadText
Lê o número especificado de caracteres de um objeto Stream de texto.
Sintaxe
String = Stream.ReadText ( NumChars)
Parâmetros
numchars
Opcional. Um valor Long que especifica o número de caracteres a serem lidos do arquivo ou um valor StreamReadEnum. O valor padrão é adReadAll.
Valor retornado
O método ReadText lê um número especificado de caracteres, uma linha inteira ou todo o fluxo de um objeto Stream e retorna a cadeia de caracteres resultante.
Observações
Se NumChar for maior do que o número de caracteres restantes no fluxo, somente os caracteres restantes serão retornados. A leitura da cadeia de caracteres não é adicionada para corresponder ao comprimento especificado por NumChar. Se não houver nenhum caractere a ser lido, uma variante cujo valor é nulo será retornada. ReadText não podem ser usados para ler para trás.
Nota
O método ReadText é usado com fluxos de texto (Type é adTypeText). Para fluxos binários (Type é adTypeBinary), use de Leitura.
Consultas que resultam em uma grande quantidade de dados XML sendo retornados por meio do método ReadText do objeto Stream do ADO (ActiveX Data Object) podem levar muito tempo para serem executadas; se isso for feito em um componente COM+ invocado de uma página ASP, a sessão do usuário poderá atingir o tempo limite. O ADO converte dados do objeto Stream da codificação UTF-8 em Unicode; a realocação de memória frequente envolvida na conversão de uma quantidade tão grande de dados ao mesmo tempo é bastante demorada. Para resolver, faça chamadas repetidas para o método ReadText do objeto de comando do ADO e especifique um número menor de caracteres. Testes mostraram que um valor equivalente a 128K (131.072) é ideal. O tempo de resposta diminui à medida que esse valor é reduzido. Para obter mais informações, consulte o artigo da Base de Dados de Conhecimento 280067: "PRB: recuperar documentos XML muito grandes do SQL Server 2000 usando o método ReadText do objeto de fluxo do ADO pode ser lento", na Base de Dados de Conhecimento da Microsoft em https://support.microsoft.com.