FileMode 枚举
指定操作系统打开文件的方式。
**命名空间:**System.IO
**程序集:**mscorlib（在 mscorlib.dll 中）
语法
声明
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration FileMode
用法
Dim instance As FileMode
[SerializableAttribute]
[ComVisibleAttribute(true)]
public enum FileMode
[SerializableAttribute]
[ComVisibleAttribute(true)]
public enum class FileMode
/** @attribute SerializableAttribute() */
/** @attribute ComVisibleAttribute(true) */
public enum FileMode
SerializableAttribute
ComVisibleAttribute(true)
public enum FileMode
成员
| 成员名称 | 说明 | |
|---|---|---|
.gif) |
Append | 打开现有文件并查找到文件尾，或创建新文件。FileMode.Append 只能同 FileAccess.Write 一起使用。任何读尝试都将失败并引发 ArgumentException。 |
|
Create | 指定操作系统应创建新文件。如果文件已存在，它将被改写。这要求 FileIOPermissionAccess.Write。System.IO.FileMode.Create 等效于这样的请求：如果文件不存在，则使用 CreateNew；否则使用 Truncate。 |
|
CreateNew | 指定操作系统应创建新文件。此操作需要 FileIOPermissionAccess.Write。如果文件已存在，则将引发 IOException。 |
|
Open | 指定操作系统应打开现有文件。打开文件的能力取决于 FileAccess 所指定的值。如果该文件不存在，则引发 System.IO.FileNotFoundException。 |
|
OpenOrCreate | 指定操作系统应打开文件（如果文件存在）；否则，应创建新文件。如果用 FileAccess.Read 打开文件，则需要 FileIOPermissionAccess.Read。如果文件访问为 FileAccess.Write 或 FileAccess.ReadWrite，则需要 FileIOPermissionAccess.Write。如果文件访问为 FileAccess.Append，则需要 FileIOPermissionAccess.Append。 |
|
Truncate | 指定操作系统应打开现有文件。文件一旦打开，就将被截断为零字节大小。此操作需要 FileIOPermissionAccess.Write。试图从使用 Truncate 打开的文件中进行读取将导致异常。 |
备注
有关创建文件和向文件中写入文本的示例，请参见 如何：向文件写入文本。有关从文件中读取文本的示例，请参见 如何：从文件读取文本。有关读取和写入二进制文件的示例，请参见 如何：对新建的数据文件进行读取和写入。
FileMode 参数在 FileStream 和 IsolatedStorageFileStream 的许多构造函数中，以及在 File 和 FileInfo 的 Open 方法中指定，用以控制打开文件的方式。
FileMode 参数控制是否对文件执行改写、创建、打开等操作，或执行这些操作的组合。使用 Open 打开现有文件。若要追加到文件，请使用 Append。若要截断文件或创建不存在的文件，请使用 Create。
示例
下面的 FileStream 构造函数打开现有文件 (FileMode.Open)。
Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)
FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);
FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read );
FileStream s2 = new FileStream(name, FileMode.Open,
FileAccess.Read, FileShare.Read);
var s2 : FileStream = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0
请参见
参考
System.IO 命名空间
File.Open
FileInfo.Open
FileStream
IsolatedStorageFileStream