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 方法