ReadText 方法

  • 项目

从文本 Stream 对象中读取指定数量的字符。

语法

  
String = Stream.ReadText ( NumChars)

参数

NumChars
可选。 一个长整型值，指定要从文件中读取的字符数，或者一个 StreamReadEnum 值。 默认值为 adReadAll。

返回值

ReadText 方法从 Stream 对象中读取指定数量的字符、整行或整个流，并返回结果字符串。

备注

如果 NumChar 大于流中剩余的字符数，则仅返回剩余的字符。 读取的字符串没有填充，为的是匹配由 NumChar 指定的长度。 如果没有剩余要读取的字符，则返回值为 null 的变体。 ReadText 不能用于向后读取。

注意

ReadText 方法与文本流（Type 为 adTypeText）一起使用。 对于二进制流（Type 为 adTypeBinary），请使用 Read。

导致通过 ActiveX 数据对象 (ADO) Stream 对象的 ReadText 方法返回大量 XML 数据的查询可能需要很长时间才能执行；如果这是在从 ASP 页调用的 COM+ 组件中完成的，则用户的会话可能会超时。ADO 将 Stream 对象数据从 UTF-8 编码转换为 Unicode；一次转换如此大量数据所涉及的频繁内存重新分配非常耗时。 要解决此问题，请重复调用 ADO 命令对象的 ReadText 方法，并指定较少的字符数。 测试表明，等效于 128K (131,072) 的值是最佳值。 响应时间随着该值的减小而减小。 有关详细信息，请参阅 Microsoft 知识库中的知识库文章 280067，“PRB：使用 ADO 流对象的 ReadText 方法从 SQL Server 2000 检索非常大的 XML 文档可能很慢”，网址为 https://support.microsoft.com。

应用于

流对象 (ADO)

另请参阅

Read 方法