TStream类说明文档

TStream

求助编辑百科名片

 

本词条主要介绍 TStream

Stream 对象，又称流式对象，是

TStream、THandleStream、TFileStream、TMemoryStream、TResourceStream 和

TBlobStream 等的统称。它们分别代表了在各种媒介上存储数据的能力，它们将各种数据

类型(包括对象和部件)

继承的对象用于在内存、Windows 资源文件、磁盘文件和数据库字段等媒介中存储数据。

　　Stream 中定义了两个属性：Size 和 Position。它们分别以字节为单位表示的流的大小

和当前指针位置。TStream 中定义的方法用于在各种流中读、写和相互拷贝二进制数据。

因为所有的 Stream 对象都是从 TStream 中继承来的，所以在 TStream 中定义的域和方法

都能被 Stream 对象调用和访

　　问。此外，又由于面向对象技术的动态联编功能，TStream 为各种流的应用提供了统

一的接口，简化了流的使用；不同 Stream 对象是抽象了对不同存储媒介的数据上的操作，

因此，TStream 的需方法为在不同媒介间的数据拷贝提供了最简捷的手段。

　　TStream 的属性和方法

　　1. Position 属性　

　　声明：function CopyFrom(Source: TStream; Count: Longint): Longint;

　　CopyFrom 从 Source 所指定的流中拷贝 Count 个字节到当前流中， 并将指针从当前

位置移动 Count 个字节数，函数返回值是实际拷贝的字节数。

　　4. Read 方法

　　声明：function Read(var Buffer; Count: Longint): Longint; virtual; abstract;

　　Read 方法从当前流中的当前位置起将 Count 个字节的内容复制到 Buffer 中，并把当

前指针向后移动 Count 个字节数，函数返回值是实际读的字节数。如果返回值小于

Count，这意味着读操作在读满所需字节数前指针已经到达了流的尾部。

　　Read 方法是抽象方法。每个后继 Stream 对象都要根据自己特有的有关特定存储媒介

的读操作覆盖该方法。而且流的所有其它的读数据的方法（如：

　　ReadBuffer 方法从流中将 Count 个字节复制到 Buffer 中， 并将流的当前指针向后移

动 Count 个字节。如读操作超过流的尾部，ReadBuffer 方法引起 EReadError 异常事件。

　　6. ReadComponent 方法

　　声明：function ReadComponent(Instance: TComponent): TComponent;

　　ReadComponent 方法从当前流中读取由 Instance 所指定的部件，函数返回所读的部

件。ReadComponent 在读 Instance 及其拥有的所有对象时创建了一个 Reader 对象并调

用它的 ReadRootComponent 方法。

　　如果 Instance 为 nil，ReadComponent 的方法基于流中描述的部件类型信息创建部件，

并返回新创建的部件。

　　7. ReadComponentRes 方法

EInvalidImage 异常事件。在 Classes 库单元中也包含一个名为 ReadComponentRes 的函

数，该函数执行相同的操作，只不过它基于应

　　用程序包含的资源建立自己的流。

　　8. ReadResHeader 方法

　　声明：procedure ReadResHeader;

　　ReadResHeader 方法从流的当前位置读取 Windows 资源文件头，并将流的当前位置

指针移到该文件头的尾部。如果流不包含一个有效的资源文件头，ReadResHeader 将引

发一个 EInvalidImage 异常事件。

　　流的 ReadComponentRes 方法在从资源文件中读取部件之前，会自动调用

ReadResHeader 方法，因此，通常程序员通常不需要自己调用它。

　　━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

　　常量　值　Seek 的起点 Offset 的取值

　　─────────────────────────────────

　　SoFromBeginning 0 流的开头 正 数

　　SoFromCurrent 1 流的当前位置 正数或负数

　　SoFromEnd 2 流的结尾 负 数

　　function Write(const Buffer; Count: Longint): Longint; virtual; abstract;

　　Write 方法将 Buffer 中的 Count 个字节写入流中，并将当前位置指针向流的尾部移动

Count 个字节，函数返回写入的字节数。

　　TStream 的 Write 方法是抽象的，每个继承的 Stream 对象都要通过覆盖该方法来提供

向特定存储媒介(内存、磁盘文件等)写数据的特定方法。流的其它所有写数据的方法(如

WriteBuffer、WriteComponent)都调用 Write 担当实际的写操作。

　　11. WriteBuffer 方法

　　声明：procedure WriteBuffer(const Buffer; Count: Longint);

　　WriteBuffer 的功能与 Write 相似。WriteBuffer 方法调用 Write 来执行实际的写操作，

如果流没能写所有字节，WriteBuffer 会触发一个 EWriteError 异常事件。

对象的 WriteComponent 将指定部件的属性值写入 Writer 对象的流中。

　　procedure WriteComponent(Instance: Tcomponent);

　　WriteComponent 创建一个 Writer 对象，并调用 Writer 的 WriteRootComponent 方法

将 Instance 及其拥有的对象写入流。

　　13. WriteComponentRes 方法

　　声明：WriteComponentRes(const ResName: String; Instance: TComponent);

　　WriteComponentRes 方法首先往流中写入标准 Windows 资源文件头，然后将

Instance 指定的部件写入流中。要读由 WriteComponentRes 写入的部件，必须调用

ReadComponentRes 方法。

　　WriteComponentRes 使用 ResName 传入的字符串作为资源文件头的资源名，然后调

用 WriteComponent 方法将 Instance 和它拥有的部件写入流。

　　14. WriteDescendant 方法

　　Instance, Ancestor: TComponent);