Compartir a través de


Método ReadText

Lee el número especificado de caracteres de un objeto Stream de texto.

Sintaxis

  
String = Stream.ReadText ( NumChars)  

Parámetros

NumChars
Opcional. Valor Long que especifica el número de caracteres que se van a leer del archivo o un valor streamReadEnum. El valor predeterminado es adReadAll.

Valor devuelto

El método ReadText lee un número especificado de caracteres, una línea completa o toda la secuencia de un objeto Stream y devuelve la cadena resultante.

Comentarios

Si NumChar es mayor que el número de caracteres que quedan en la secuencia, solo se devuelven los caracteres restantes. La cadena leída no se rellena para que coincida con la longitud especificada por NumChar. Si no queda ningún carácter para leer, se devuelve una variante cuyo valor es NULL. ReadText no se puede usar para leer hacia atrás.

Nota

El método ReadText se usa con secuencias de texto (Type es adTypeText). Para secuencias binarias (el tipo es adTypeBinary), use Read.

Las consultas que dan lugar a una gran cantidad de datos XML que se devuelven a través del método ReadText del objeto Stream de Objeto de datos ActiveX (ADO) pueden tardar mucho tiempo en ejecutarse; Si esto se hace en un componente COM+ que se invoca desde una página ASP, la sesión del usuario puede agotar el tiempo de espera. ADO convierte los datos de objeto Stream de la codificación UTF-8 a Unicode; la reasignación de memoria frecuente implicada en la conversión de una gran cantidad de datos a la vez es bastante lento. Para resolverlo, realice llamadas repetidas al método ReadText del objeto de comando de ADO y especifique un número menor de caracteres. Las pruebas han demostrado que un valor equivalente a 128K (131 072) es óptimo. El tiempo de respuesta disminuye a medida que se reduce este valor. Para obtener más información, vea el artículo de Knowledge Base 280067, "PRB: Recuperación de documentos XML muy grandes de SQL Server 2000 mediante el método ReadText del objeto de flujo de ADO puede ser lento", en Microsoft Knowledge Base en https://support.microsoft.com.

Se aplica a

Objeto de secuencia (ADO)

Consulte también

Método Read