ReadText, metodo
Legge il numero specificato di caratteri da un oggetto stream.
Sintassi
String = Stream.ReadText ( NumChars)
Parametri
NumChars
Opzionale. 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 in modo da corrispondere alla lunghezza specificata da NumChar. Se non sono presenti caratteri da leggere, viene restituita una variante il cui valore è Null. non è possibile utilizzare ReadText per leggere le versioni precedenti.
Nota
Il metodo ReadText viene utilizzato 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 implicata nella conversione di una quantità così elevata di dati contemporaneamente richiede molto tempo. Per risolvere il problema, effettuare chiamate ripetute al metodo ReadText dell'oggetto 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 viene ridotto. Per altre informazioni, vedere l'articolo della Knowledge Base 280067" "PRB: Recupero di documenti XML di grandi dimensioni da SQL Server 2000 tramite il metodo ReadText dell'oggetto flusso ADO potrebbe essere lento" nella Microsoft Knowledge Base in https://support.microsoft.com.