基本的文件 I/O

抽象基类 Stream 支持读取和写入字节。 Stream 集成了异步支持。 其默认实现根据其相应的异步方法来定义同步读取和写入,反之亦然。

所有表示流的类都是从 Stream 类继承的。 Stream 类及其派生类提供数据源和储存库的一般视图,使程序员不必了解操作系统和基础设备的具体细节。

流涉及三个基本操作:

  • 可以从流读取。 读取是从流到数据结构(如字节数组)的数据传输。

  • 可以向流写入。 写入是从数据源到流的数据传输。

  • 流可以支持查找。 查找是对流内的当前位置进行的查询和修改。

根据基础数据源或储存库,流可能只支持这些功能中的一部分。 例如,NetworkStreams 不支持查找。 Stream 及其派生类的 CanReadCanWriteCanSeek 属性决定了不同流所支持的操作。

有关通用 I/O 任务的列表,请参见通用 I/O 任务

注意注意

Visual Basic 用户可以选择使用由 Microsoft.VisualBasic.FileIO.FileSystem 类提供的方法和属性执行文件 I/O 操作。

用于文件 I/O 的类

Directory 提供创建、移动和枚举目录和子目录的静态方法。 DirectoryInfo 类提供实例方法。

DirectoryInfo 提供创建、移动和枚举目录和子目录的实例方法。 Directory 类提供静态方法。

DriveInfo 提供访问有关驱动器的信息的实例方法。

File 提供用于创建、复制、删除、移动和打开文件的静态方法,并协助创建 FileStreamFileInfo 类提供实例方法。

FileInfo 提供用于创建、复制、删除、移动和打开文件的实例方法,并协助创建 FileStreamFile 类提供静态方法。

FileStream 支持通过其 Seek 方法随机访问文件。 默认情况下,FileStream 以同步方式打开文件,但它也支持异步操作。 File 包含静态方法,而 FileInfo 包含实例方法。

FileSystemInfoFileInfoDirectoryInfo 的抽象基类。

Path 提供以跨平台的方式处理目录字符串的方法和属性。

DeflateStream 提供使用 Deflate 算法压缩和解压缩流的方法和属性。

GZipStream 提供压缩和解压缩流的方法和属性。 默认情况下,此类使用与 DeflateStream 类相同的算法,但可以扩展到使用其他压缩格式。

SerialPort 提供控制串行端口文件资源的方法和属性。

FileFileInfoDriveInfoPathDirectoryDirectoryInfo 是密封(在 Microsoft Visual Basic 中为 NotInheritable)类。 可以创建这些类的新实例,但它们不能有派生类。

用于从流读取和写入流的类

BinaryReaderBinaryWriterStreams 中读取和写入编码的字符串和基元数据类型。

StreamReader 通过使用 Encoding 进行字符和字节的转换,从 Streams 中读取字符。 StreamReader 具有一个构造函数,该构造函数根据是否存在专用于 Encodingpreamble(例如一个字节顺序标记)来尝试确定给定 Stream 的正确 Encoding 是什么。

StreamWriter 通过使用 Encoding 将字符转换为字节,向 Streams 写入字符。

StringReaderStrings 中读取字符。 StringReader 允许您用相同的 API 来处理 Strings,因此您的输出可以是 String 或以任何编码表示的 Stream

StringWriterStrings 写入字符。 StringWriter 允许您用相同的 API 来处理 Strings,因此您的输出可以是 String 或以任何编码表示的 Stream

TextReaderStreamReaderStringReader 的抽象基类。 抽象 Stream 类的实现用于字节输入和输出,而 TextReader 的实现用于 Unicode 字符输出。

TextWriterStreamWriterStringWriter 的抽象基类。 抽象 Stream 类的实现用于字节输入和输出,而 TextWriter 的实现用于 Unicode 字符输出。

通用 I/O 流类

BufferedStream 是向另一个 Stream(例如 NetworkStream)添加缓冲的 Stream。 (FileStream 内部已具有缓冲,MemoryStream 不需要缓冲。)BufferedStream 可以围绕某些类型的流来构成以提高读写性能。 缓冲区是内存中的字节块,用于缓存数据,从而减少对操作系统的调用次数。

CryptoStream 将数据流链接到加密转换。 虽然 CryptoStream 是从 Stream 派生的,但它不属于 System.IO 命名空间,而是在 System.Security.Cryptography 命名空间中。

MemoryStream 是一个非缓冲的流,可以在内存中直接访问它的封装数据。 该流没有后备存储,可用作临时缓冲区。

NetworkStream 表示网络连接上的 Stream。 虽然 NetworkStream 是从 Stream 派生的,但它不属于 System.IO 命名空间,而是在 System.Net.Sockets 命名空间中。

I/O 和安全性

当在 System.IO 命名空间中使用类时,要使访问被允许,则必须满足诸如访问控制列表 (ACL) 等操作系统安全性要求。 此要求是在所有 FileIOPermission 要求之外的要求。

注意注意

可以以编程方式管理 ACL。有关更多信息,请参见如何:添加或移除访问控制列表项ACL 技术概述

警告说明警告

Internet 和 Intranet 的默认安全策略不允许访问文件。因此,如果您在编写将通过 Internet 下载的代码,则不要使用常规的非独立存储 I/O 类。请改用独立存储

警告说明警告

当文件或网络流打开时,只有在构造流时才执行安全检查。因此,在将这些流分发给受信度较低的代码或应用程序域时,请格外小心。

请参见

任务

如何:创建目录列表

如何:对新建的数据文件进行读取和写入

如何:打开并追加到日志文件

如何:从文件读取文本

如何:向文件写入文本

如何:从字符串中读取字符

如何:向字符串写入字符

概念

通用 I/O 任务