Método ReadText

Lê um 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.

Comentários

Se NumChar for maior que o número de caracteres restantes no fluxo, somente os caracteres restantes serão retornados. A leitura da cadeia de caracteres não é preenchida para corresponder ao tamanho especificado por NumChar. Se não houver nenhum caractere para ler, uma variante cujo valor é nulo será retornada. ReadText não pode ser usado para a leitura de trás para frente.

Observação

O método ReadText é usado com fluxos de texto (o Type is adTypeText). Para fluxos binários (Type é adTypeBinary), use Read.

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+ que é 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 isso, faça chamadas repetidas ao método ReadText do objeto de comando 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 saber mais, confira o artigo da Base de Dados de Conhecimento 280067: "PRB: a recuperação de documentos XML muito grandes do SQL Server 2000 usando o método ReadText do objeto de fluxo ADO pode ser lenta", na Base de Dados de Conhecimento da Microsoft em https://support.microsoft.com.

Aplica-se A

Objeto Stream (ADO)

Consulte Também

Método Read