Teilen über


ReadText-Methode

Liest eine angegebene Anzahl von Zeichen aus einem Text-Stream-Objekt.

Syntax

  
String = Stream.ReadText ( NumChars)  

Parameter

NumChars
Optional. Ein Long-Wert, der die Anzahl der Zeichen angibt, die aus der Datei oder einem StreamReadEnum-Wert gelesen werden sollen. 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 größer als die Anzahl der Zeichen im Datenstrom ist, werden nur die verbleibenden Zeichen zurückgegeben. Der Zeichenfolgenlesevorgang wird nicht aufgefüllt, um die mittels NumChar angegebene Länge zu erreichen. Wenn keine zu lesenden Zeichen vorhanden sind, wird eine Variante zurückgegeben, deren Wert null ist. ReadText kann nicht verwendet werden, um rückwärts zu lesen.

Hinweis

Die ReadText-Methode wird mit Textstreams verwendet (der Typ ist adTypeText). Verwenden Sie für Binärdatenströme (vom TypadTypeBinary) die Read-Methode.

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 für die Ausführung erfordern. Wenn dies in einer COM+-Komponente erfolgt, die von einer ASP-Seite aufgerufen wird, kann die Sitzung des Benutzers die vorgesehene Zeit überschreiten. ADO konvertiert Stream-Objektdaten aus der UTF-8-Codierung in Unicode. Die häufige Speicherneuzuordnung, die bei der Konvertierung einer derart großen Menge an Daten gleichzeitig beteiligt ist, ist ziemlich zeitaufwendig. Führen Sie wiederholte Aufrufe an die ReadText-Methode des ADO-Befehlsobjekts aus, und geben Sie eine kleinere Anzahl von Zeichen an. Tests haben gezeigt, dass ein Wert von 128K (131.072) optimal ist. Die Antwortzeit verringert sich, wenn 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 möglicherweise langsam“ in der Microsoft Knowledge Base unter https://support.microsoft.com.

Gilt für

Stream-Objekt (ADO)

Weitere Informationen

Read-Methode