FileMode 枚举

  • 参考

定义

命名空间:
System.IO
程序集:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
程序集:
System.Runtime.dll
程序集:
System.IO.FileSystem.Primitives.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

指定操作系统打开文件的方式。

public enum class FileMode
public enum FileMode
[System.Serializable]
public enum FileMode
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FileMode
type FileMode = 
[<System.Serializable>]
type FileMode = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileMode = 
Public Enum FileMode
继承
Object
ValueType
Enum
FileMode
属性
SerializableAttribute ComVisibleAttribute

字段

Append 6

若存在文件，则打开该文件并查找到文件尾，或者创建一个新文件。 这需要 Append 权限。 FileMode.Append 只能与 FileAccess.Write 一起使用。 试图查找文件尾之前的位置时会引发 IOException 异常，并且任何试图读取的操作都会失败并引发 NotSupportedException 异常。
Create 2

指定操作系统应创建新文件。 如果此文件已存在，则会将其覆盖。 这需要 Write 权限。 FileMode.Create 等效于这样的请求：如果文件不存在，则使用 CreateNew；否则使用 Truncate。 如果该文件已存在但为隐藏文件，则将引发 UnauthorizedAccessException异常。
CreateNew 1

指定操作系统应创建新文件。 这需要 Write 权限。 如果文件已存在，则将引发 IOException异常。
Open 3

指定操作系统应打开现有文件。 打开文件的能力取决于 FileAccess 枚举所指定的值。 如果文件不存在，引发一个 FileNotFoundException 异常。
OpenOrCreate 4

指定操作系统应打开文件（如果文件存在）；否则，应创建新文件。 如果用 FileAccess.Read 打开文件，则需要 Read权限。 如果文件访问为 FileAccess.Write，则需要 Write权限。 如果用 FileAccess.ReadWrite 打开文件，则同时需要 Read 和 Write权限。
Truncate 5

指定操作系统应打开现有文件。 该文件被打开时，将被截断为零字节大小。 这需要 Write 权限。 尝试从使用 FileMode.Truncate 打开的文件中进行读取将导致 ArgumentException 异常。

示例

以下 FileStream 构造函数打开现有文件 (FileMode.Open) 。

FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read );

FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);

Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)

注解

有关创建文件和将文本写入文件的示例，请参阅 “如何：将文本写入文件”。 有关从文件读取文本的示例，请参阅 “如何：从文件读取文本”。 有关读取和写入二进制文件的示例，请参阅 如何：读取和写入新创建的数据文件。

参数 FileMode 在许多构造函数 FileStream中指定， IsolatedStorageFileStream并在 Open 方法 File 中指定并 FileInfo 控制文件打开方式。

FileMode 参数控制文件是覆盖、创建、打开还是某种组合。 用于 Open 打开现有文件。 若要追加到文件，请使用 Append。 若要截断文件或创建文件（如果不存在），请使用 Create。

适用于

另请参阅