C#文件操作之FileMode

阳光穿透心脏的1/2处 2022-08-09 02:11 104阅读 0赞

# FileMode 枚举 #

**.NET Framework 4.6 and 4.5**

其他版本

![ImageSprite.png_v_635786533221101412][]

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

**命名空间：** [System.IO][]  
**程序集：** mscorlib（在 mscorlib.dll 中）  
System.IO.FileSystem.Primitives（在 System.IO.FileSystem.Primitives.dll 中）

## 语法 ##

C\#

[C++][C]

[F\#][F]

[VB][]

[SerializableAttribute]
    [ComVisibleAttribute(true)]
    public enum FileMode

### Members ###

<table style="border-collapse:collapse; margin-bottom:20px; margin-top:20px; width:674px; border:1px solid rgb(187,187,187)"> 
 <tbody> 
 <tr> 
 <th style="padding:10px 8px; color:rgb(99,99,99); border:1px solid rgb(187,187,187); font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; background-color:rgb(237,237,237)"> &nbsp;</th> 
 <th style="padding:10px 8px; color:rgb(99,99,99); border:1px solid rgb(187,187,187); font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; background-color:rgb(237,237,237)"> 成员名称</th> 
 <th style="padding:10px 8px; color:rgb(99,99,99); border:1px solid rgb(187,187,187); font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; background-color:rgb(237,237,237)"> 描述</th> 
 </tr> 
 <tr> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> <img alt="由 XNA Framework 提供支持" src="https://i-msdn.sec.s-msft.com/areas/global/content/clear.gif" title="由 XNA Framework 提供支持" style="border:0px; width:16px; height:16px; overflow:hidden; max-width:none"></td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> Append</td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> 若存在文件，则打开该文件并查找到文件尾，或者创建一个新文件。&nbsp;这需要<a href="https://msdn.microsoft.com/zh-cn/library/system.security.permissions.fileiopermissionaccess%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileIOPermissionAccess.Append</a>&nbsp;权限。&nbsp;FileMode.Append&nbsp;只能与FileAccess.Write&nbsp;一起使用。&nbsp;试图查找文件尾之前的位置时会引发<a href="https://msdn.microsoft.com/zh-cn/library/system.io.ioexception%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">IOException</a>&nbsp;异常，并且任何试图读取的操作都会失败并引发<a href="https://msdn.microsoft.com/zh-cn/library/system.notsupportedexception%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">NotSupportedException</a>&nbsp;异常。</td> 
 </tr> 
 <tr> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> <img alt="由 XNA Framework 提供支持" src="https://i-msdn.sec.s-msft.com/areas/global/content/clear.gif" title="由 XNA Framework 提供支持" style="border:0px; width:16px; height:16px; overflow:hidden; max-width:none"></td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> Create</td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> 指定操作系统应创建新文件。&nbsp;如果文件已存在，它将被覆盖。&nbsp;这需要<a href="https://msdn.microsoft.com/zh-cn/library/system.security.permissions.fileiopermissionaccess%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileIOPermissionAccess.Write</a>&nbsp;权限。&nbsp;FileMode.Create&nbsp;等效于这样的请求：如果文件不存在，则使用&nbsp;CreateNew；否则使用&nbsp;Truncate。&nbsp;如果该文件已存在但为隐藏文件，则将引发&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.unauthorizedaccessexception%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">UnauthorizedAccessException</a>异常。</td> 
 </tr> 
 <tr> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> <img alt="由 XNA Framework 提供支持" src="https://i-msdn.sec.s-msft.com/areas/global/content/clear.gif" title="由 XNA Framework 提供支持" style="border:0px; width:16px; height:16px; overflow:hidden; max-width:none"></td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> CreateNew</td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> 指定操作系统应创建新文件。&nbsp;这需要&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.security.permissions.fileiopermissionaccess%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileIOPermissionAccess.Write</a>&nbsp;权限。&nbsp;如果文件已存在，则将引发&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.io.ioexception%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">IOException</a>异常。</td> 
 </tr> 
 <tr> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> <img alt="由 XNA Framework 提供支持" src="https://i-msdn.sec.s-msft.com/areas/global/content/clear.gif" title="由 XNA Framework 提供支持" style="border:0px; width:16px; height:16px; overflow:hidden; max-width:none"></td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> Open</td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> 指定操作系统应打开现有文件。&nbsp;打开文件的能力取决于&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/4z36sx0f%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileAccess</a>&nbsp;枚举所指定的值。&nbsp;如果文件不存在，引发一个&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.io.filenotfoundexception%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">System.IO.FileNotFoundException</a>&nbsp;异常。</td> 
 </tr> 
 <tr> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> <img alt="由 XNA Framework 提供支持" src="https://i-msdn.sec.s-msft.com/areas/global/content/clear.gif" title="由 XNA Framework 提供支持" style="border:0px; width:16px; height:16px; overflow:hidden; max-width:none"></td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> OpenOrCreate</td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> 指定操作系统应打开文件（如果文件存在）；否则，应创建新文件。&nbsp;如果用FileAccess.Read&nbsp;打开文件，则需要&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.security.permissions.fileiopermissionaccess%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileIOPermissionAccess.Read</a>权限。&nbsp;如果文件访问为&nbsp;FileAccess.Write，则需要&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.security.permissions.fileiopermissionaccess%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileIOPermissionAccess.Write</a>权限。&nbsp;如果用&nbsp;FileAccess.ReadWrite&nbsp;打开文件，则同时需要<a href="https://msdn.microsoft.com/zh-cn/library/system.security.permissions.fileiopermissionaccess%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileIOPermissionAccess.Read</a>&nbsp;和&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.security.permissions.fileiopermissionaccess%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileIOPermissionAccess.Write</a>权限。</td> 
 </tr> 
 <tr> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> <img alt="由 XNA Framework 提供支持" src="https://i-msdn.sec.s-msft.com/areas/global/content/clear.gif" title="由 XNA Framework 提供支持" style="border:0px; width:16px; height:16px; overflow:hidden; max-width:none"></td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> Truncate</td> 
 <td style="font-family:'Microsoft YaHei UI','Microsoft YaHei',SimSun,'Segoe UI','Lucida Grande',Verdana,Arial,Helvetica,sans-serif!important; padding:10px 8px; color:rgb(42,42,42); vertical-align:top; min-width:72px; border:1px solid rgb(187,187,187)"> 指定操作系统应打开现有文件。&nbsp;该文件被打开时，将被截断为零字节大小。&nbsp;这需要&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.security.permissions.fileiopermissionaccess%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">FileIOPermissionAccess.Write</a>&nbsp;权限。&nbsp;尝试从使用&nbsp;FileMode.Truncate打开的文件中进行读取将导致&nbsp;<a href="https://msdn.microsoft.com/zh-cn/library/system.argumentexception%28v=vs.110%29.aspx" style="text-decoration:none; color:rgb(3,105,122)" rel="nofollow">ArgumentException</a>&nbsp;异常。</td> 
 </tr> 
 </tbody> 
</table>

## 备注 ##

有关创建文件和向文件中写入文本的示例，请参见 [如何：向文件写入文本][Link 1]。 有关从文件中读取文本的示例，请参见 [如何：从文件读取文本][Link 2]。 有关读取和写入二进制文件的示例，请参见 [如何：对新建的数据文件进行读取和写入][Link 3]。

FileMode 参数在 [FileStream][] 和 [IsolatedStorageFileStream][] 的许多构造函数中，以及在 [File][] 和 [FileInfo][] 的 Open方法中指定，用以控制打开文件的方式。

FileMode 参数控制是否对文件执行覆盖、创建、打开等操作，或执行这些操作的组合。 使用 Open 打开现有文件。若要追加到文件，请使用 Append。 若要截断文件或创建不存在的文件，请使用 Create。

## 示例 ##

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

C\#

[C++][C 1]

[VB][VB 1]

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

## 版本信息 ##

#### .NET Framework ####

受以下版本支持：4.6、4.5、4、3.5、3.0、2.0、1.1

#### .NET Framework Client Profile ####

受以下版本支持：4、3.5 SP1

#### 适用于 Windows Phone 应用的 .NET ####

受以下版本支持：Windows Phone 8.1、Windows Phone Silverlight 8

## 平台 ##

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008（不支持服务器核心角色）, Windows Server 2008 R2（支持带 SP1 或更高版本的服务器核心角色；不支持 Itanium）

.NET Framework 并非支持每个平台的所有版本。有关支持的版本的列表，请参阅 [.NET Framework 系统要求][.NET Framework]。

## 请参阅 ##

#### 参考 ####

[System.IO 命名空间][System.IO]

[File.Open][]

[FileInfo.Open][]

[FileStream][]

[IsolatedStorageFileStream][]

#### 其他资源 ####

[文件和流 I/O][I_O]

[如何：从文件读取文本][Link 2]

[如何：向文件写入文本][Link 1]

[如何：对新建的数据文件进行读取和写入][Link 3]

[ImageSprite.png_v_635786533221101412]: https://i-msdn.sec.s-msft.com/Areas/Epx/Content/Images/ImageSprite.png?v=635786533221101412
[System.IO]: https://msdn.microsoft.com/zh-cn/library/system.io%28v=vs.110%29.aspx
[C]: https://msdn.microsoft.com/zh-cn/library/system.io.filemode%28v=vs.110%29.aspx?cs-save-lang=1&cs-lang=cpp#code-snippet-1
[F]: https://msdn.microsoft.com/zh-cn/library/system.io.filemode%28v=vs.110%29.aspx?cs-save-lang=1&cs-lang=fsharp#code-snippet-1
[VB]: https://msdn.microsoft.com/zh-cn/library/system.io.filemode%28v=vs.110%29.aspx?cs-save-lang=1&cs-lang=vb#code-snippet-1
[Link 1]: https://msdn.microsoft.com/zh-cn/library/6ka1wd3w%28v=vs.110%29.aspx
[Link 2]: https://msdn.microsoft.com/zh-cn/library/db5x7c0d%28v=vs.110%29.aspx
[Link 3]: https://msdn.microsoft.com/zh-cn/library/36b93480%28v=vs.110%29.aspx
[FileStream]: https://msdn.microsoft.com/zh-cn/library/system.io.filestream%28v=vs.110%29.aspx
[IsolatedStorageFileStream]: https://msdn.microsoft.com/zh-cn/library/system.io.isolatedstorage.isolatedstoragefilestream%28v=vs.110%29.aspx
[File]: https://msdn.microsoft.com/zh-cn/library/system.io.file%28v=vs.110%29.aspx
[FileInfo]: https://msdn.microsoft.com/zh-cn/library/system.io.fileinfo%28v=vs.110%29.aspx
[C 1]: https://msdn.microsoft.com/zh-cn/library/system.io.filemode%28v=vs.110%29.aspx?cs-save-lang=1&cs-lang=cpp#code-snippet-2
[VB 1]: https://msdn.microsoft.com/zh-cn/library/system.io.filemode%28v=vs.110%29.aspx?cs-save-lang=1&cs-lang=vb#code-snippet-2
[.NET Framework]: https://msdn.microsoft.com/zh-cn/library/8z6watww%28v=vs.110%29.aspx
[File.Open]: https://msdn.microsoft.com/zh-cn/library/system.io.file.open%28v=vs.110%29.aspx
[FileInfo.Open]: https://msdn.microsoft.com/zh-cn/library/system.io.fileinfo.open%28v=vs.110%29.aspx
[I_O]: https://msdn.microsoft.com/zh-cn/library/k3352a4t%28v=vs.110%29.aspx