ReadText-Methode
Liest die angegebene Anzahl von Zeichen aus einem Text Stream-Objekt.
Syntax
String = Stream.ReadText ( NumChars)
Parameter
NumChars-
Wahlfrei. Ein Long-Wert, der die Anzahl der Zeichen angibt, die aus der Datei gelesen werden sollen, oder ein StreamReadEnum-wert. Der Standardwert ist adReadAll-.
Rückgabewert
Die ReadText--Methode liest eine angegebene Anzahl von Zeichen, eine ganze Zeile oder den gesamten Datenstrom aus einem Stream-Objekt und gibt die resultierende Zeichenfolge zurück.
Bemerkungen
Wenn NumChar- mehr als die Anzahl der im Datenstrom verbleibenden Zeichen ist, werden nur die verbleibenden Zeichen zurückgegeben. Der Zeichenfolgenlesevorgang ist nicht aufgefüllt, um der durch NumChar-angegebenen Länge zu entsprechen. Wenn zum Lesen keine Zeichen vorhanden sind, wird eine Variante zurückgegeben, deren Wert null ist. ReadText- kann nicht zum Rückwärtslesen verwendet werden.
Anmerkung
Die ReadText--Methode wird mit Textstreams verwendet (Type ist adTypeText). Verwenden Sie für binäre Datenströme (Type ist adTypeBinary), verwenden Sie Read.
Abfragen, die zu einer großen Menge von XML-Daten führen, die über die ReadText- Methode des ActiveX Data Object (ADO)-Stream-Objekts zurückgegeben werden, können viel Zeit in Anspruch nehmen; Wenn dies in einer COM+-Komponente erfolgt, die von einer ASP-Seite aufgerufen wird, kann die Sitzung des Benutzers timeout sein. ADO konvertiert Stream-Objektdaten aus UTF-8-Codierung in Unicode; Die häufige Speicherverlagerung, die bei der Konvertierung einer so großen Menge an Daten gleichzeitig beteiligt ist, ist ziemlich zeitaufwändig. Führen Sie wiederholte Aufrufe an die ReadText- Methode des ADO-Befehlsobjekts durch, und geben Sie eine kleinere Anzahl von Zeichen an. Tests haben gezeigt, dass ein Wert, der 128K (131.072) entspricht, optimal ist. Die Reaktionszeit verringert sich, da dieser Wert verringert wird. Weitere Informationen finden Sie im Knowledge Base-Artikel 280067: "PRB: Abrufen sehr großer XML-Dokumente aus SQL Server 2000 mithilfe der ReadText-Methode des ADO-Streamobjekts kann langsam sein", in der Microsoft Knowledge Base unter https://support.microsoft.com.