ReadText 方法

從文字 Stream 物件讀取指定的字元數目。

語法

  
String = Stream.ReadText ( NumChars)  

參數

NumChars
選擇性。 Long 值，指定要從檔案讀取的字元數或 StreamReadEnum 值。 預設值為 adReadAll。

傳回值

ReadText 方法會從 Stream 物件讀取指定的字元數、整行或整個資料流，並傳回產生的字串。

備註

如果 NumChar 超過資料流中剩餘的字元數，則只會傳回剩餘的字元。 不會填補讀取字串以符合 NumChar 指定的長度。 如果沒有剩餘要讀取的字元，則會傳回其值為 Null 的變體。 ReadText 無法用來回溯讀取。

注意

ReadText 方法會與文字資料流搭配使用 (Type 為 adTypeText)。 對於二進位資料流 (Type 為 adTypeBinary)，請使用 Read。

透過 ActiveX Data Object (ADO) Stream 物件的 ReadText 方法傳回大量 XML 資料的查詢，可能需要大量時間才能執行；如果在從 ASP 頁面叫用的 COM+ 元件中這樣做，則使用者的工作階段可能會逾時。ADO 會將 Stream 物件資料從 UTF-8 編碼轉換為 Unicode；牽涉到頻繁記憶體重新配置的此類一次轉換大量資料相當耗時。 若要解決，請重複呼叫 ADO 命令物件的 ReadText 方法，並指定較小的字元數。 測試顯示相當於 128K (131,072) 的值是最佳值。 回應時間會隨著此值減少而減少。 如需詳細資訊，請參閱知識庫文章 280067：「PRB：使用 ADO 資料流物件的 ReadText 方法，從 SQL Server 2000 擷取非常大型的 XML 文件會非常緩慢」，在 Microsoft 知識庫的網址為：https://support.microsoft.com。

套用至

Stream 物件 (ADO)

另請參閱

Read 方法