ReadText 方法

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

語法

  
String = Stream.ReadText ( NumChars)  

參數

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

傳回值

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

言論

如果 NumChar 大於數據流中留下的字元數,則只會傳回剩餘的字元。 讀取的字串不會填補,以符合 NumChar所指定的長度。 如果沒有要讀取的字元,則會傳回值為 null 的變體。 ReadText 無法用來向後讀取。

注意

ReadText 方法會與文字數據流搭配使用(TypeadTypeText)。 對於二進位數據流(Type 是 adTypeBinary),請使用 Read。

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

適用於

Stream 物件 (ADO)

另請參閱

Read 方法