Metodo ReadText

  • Articolo

Legge il numero specificato di caratteri da un oggetto Stream di testo.

Sintassi

  
String = Stream.ReadText ( NumChars)

Parametri

NumChars
facoltativo. Valore Long che specifica il numero di caratteri da leggere dal file o un valore StreamReadEnum. Il valore predefinito è adReadAll.

Valore restituito

Il metodo ReadText legge un numero specificato di caratteri, un'intera riga o l'intero flusso da un oggetto Stream e restituisce la stringa risultante.

Osservazioni

Se NumChar è maggiore del numero di caratteri rimanenti nel flusso, vengono restituiti solo i caratteri rimanenti. La stringa di lettura non viene riempita per corrispondere alla lunghezza specificata da NumChar. Se non rimangono caratteri da leggere, viene restituita una variante il cui valore è Null. ReadText non può essere utilizzato per leggere all'indietro.

Nota

Il metodo ReadText viene usato con flussi di testo (Type è adTypeText). Per i flussi binari (Type è adTypeBinary), usare Read.

Le query che comportano la restituzione di una grande quantità di dati XML tramite il metodo ReadText dell'oggetto Stream ActiveX Data Object (ADO) possono richiedere molto tempo per l'esecuzione; se questa operazione viene eseguita in un componente COM+ richiamato da una pagina ASP, la sessione dell'utente potrebbe scadere. ADO converte i dati dell'oggetto Stream dalla codifica UTF-8 a Unicode; la riallocazione frequente della memoria necessaria per convertire contemporaneamente una quantità così elevata di dati richiede molto tempo. Per risolvere il problema, effettuare chiamate ripetute al metodo ReadText dell'oggetto del comando ADO e specificare un numero minore di caratteri. I test hanno dimostrato che un valore equivalente a 128K (131.072) è ottimale. Il tempo di risposta diminuisce man mano che questo valore si riduce. Per altre informazioni, vedere l'articolo della Knowledge Base 280067, "PRB: il recupero di documenti XML di grandi dimensioni da SQL Server 2000 tramite il metodo ReadText dell'oggetto Stream ADO potrebbe essere lento" nella Knowledge Base di Microsoft all'indirizzo https://support.microsoft.com.

Si applica a

Oggetto Stream (ADO)

Vedere anche

Metodo Read