Stream 对象 (ADO version 2.5)
ADO Stream 对象用于读写以及处理二进制数据或文本流。
Stream 对象可通过三种方法获得:
- 通过指向包含二进制或文本数据的对象(通常是文件)的 URL。此对象可以是简单的文档、表示结构化文档的 Record 对象或文件夹。
- 通过将 Stream 对象实例化。这些 Stream 对象可用来存储用于应用程序的数据。跟与 URL 相关联的 Stream 或 Record 的默认 Stream 不同,实例化的 Stream 在默认情况下与基本源没有关联。
- 通过打开与 Record 对象相关联的默认 Stream 对象。打开 Record 时便可获取与 Record 对象相关联的默认流。只需打开该流便可删除一个往返过程。
语法
objectname.property objectname.method
属性
属性 |
描述 |
CharSet |
指定用于存储 Stream 的字符集。 |
EOS |
返回当前位置是否位于流的结尾。 |
LineSeparator |
设置或返回用在文本 Stream 对象中的分行符。
可选参数有:
adCR =13
adCRLF =-1
adLF =10
|
Mode |
设置或返回供修改数据的可用权限。 |
Position |
设置或返回从 Stream 对象开始处的当前位置(按字节计算)。 |
Size |
返回一个打开的 Stream 对象的大小。 |
State |
返回一个描述 Stream 是打开还是关闭的值。 |
Type |
设置或返回 Stream 对象中的数据的类型。可选参数为:
adTypeBinary =1
adTypeText =2 |
方法
方法 |
描述 |
Cancel |
Object.Cancel
取消执行挂起的异步 Execute 或 Open 方法的调用。 |
Close |
Object.Close
关闭一个 Stream 对象。 |
CopyTo |
Object.CopyTo(destStream,[CharNumber])
将对像的数据复制。
参数说明:
destStream指向要复制的对像,CharNumber为可选参数,指要复制的字节数,不选为全部复制。 |
Flush |
Object.Flush
把 Stream 缓冲区中的内容发送到相关联的下层对象。 |
LoadFromFile |
Object.LoadFromFile(FileName)
将FileName指定的文件装入对像中。 |
Open |
Object.Open(Source,[Mode],[Options],[UserName],[Password])
打开一个 Stream 对象。
参数说明:
Sourece 对像源,可不指定;
Mode 指定打开模式,可不指定,可选参数如下:
adModeRead = 1
adModeReadWrite = 3
adModeRecursive = 4194304
adModeShareDenyNone = 16
adModeShareDenyRead = 4
adModeShareDenyWrite = 8
adModeShareExclusive = 12
adModeUnknown = 0
adModeWrite = 2
Options 指定打开的选项,可不指定,可选参数如下:
adOpenStreamAsync = 1
adOpenStreamFromRecord = 4
adOpenStreamUnspecified = -1
UserName 指定用户名,可不指定。
Password 指定用户名的密码 |
Read |
Object.Read(Numbytes)
读取指定长度的二进制内容。
参数说明:
Numbytes指定的要读取的找度,不指定则读取全部。 |
ReadText |
Object.ReadText(NumChars)
读取指定长度的文本。
参数说明:
NumChars指定的要读取的找度,不指定则读取全部。 |
SaveToFile |
Object.SaveToFile(FileName,[Options])
将对像的内容写到FileName指定的文件中。
参数说明:
FileName指定的文件
Options 存取的选项,可不指定,可选参数如下:
adSaveCreateNotExist = 1
adSaveCreateOverWrite = 2 |
SetEOS |
Object.SetEOS
设置当前位置为流的结尾 (EOS) |
SkipLine |
Object.SkipLine
在读取一个文本流时跳过一行。 |
Write |
Object.Write(Buffer)
将指定的数据装入对像中。
参数说明:Buffer 为指定的要写入的内容。 |
WriteText |
Object.WriteText(Data,[Options])
将指定的文本数据装入对像中。
参数说明:
Data 为指定的要写入的内容。
Options 写入的选项,可不指定,可选参数如下:
adWriteChar = 0
adWriteLine = 1 |
参考地址:http://msdn.microsoft.com/zh-cn/library/ms677486(en-us,VS.85).aspx |