ReadText 方法

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

语法

  
String = Stream.ReadText ( NumChars)  

参数

NumChars
自选。 一个 Long 值,该值指定要从文件读取的字符数,或指定要从文件中读取的字符数,或 StreamReadEnum 值。 默认值为 adReadAll

返回值

ReadText 方法从 Stream 对象读取指定的字符数、整行或整个流,并返回生成的字符串。

言论

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

注意

ReadText 方法与文本流一起使用(类型adTypeText)。 对于二进制流(类型adTypeBinary),请使用 读取

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

适用于

Stream 对象 (ADO)

另请参阅

Read 方法