閱讀英文版本

分享方式：

FileMode 列舉

  • 參考

定義

命名空間:
System.IO
組件:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
組件:
System.Runtime.dll
組件:
System.IO.FileSystem.Primitives.dll
組件:
mscorlib.dll
組件:
netstandard.dll

指定作業系統應該如何開啟檔案。

C# 
public enum FileMode
C# 
[System.Serializable]
public enum FileMode
C# 
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FileMode
繼承
Object
ValueType
Enum
FileMode
屬性
SerializableAttribute ComVisibleAttribute

欄位

名稱 值 Description
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) 。

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

備註

如需建立檔案並將文字寫入檔案的範例，請參閱 如何：將文字寫入檔案。 如需從檔案讀取文字的範例，請參閱 如何：從檔案讀取文字。 如需讀取和寫入二進位檔的範例，請參閱 如何：讀取和寫入新建立的數據檔。

FileMode參數是在、 IsolatedStorageFileStream和 方法FileFileInfo的許多建構FileStream函式中Open指定，以控制檔案的開啟方式。

FileMode 參數可控制檔案是否會被覆寫、建立、開啟或某種組合。 使用 Open 開啟現有的檔案。 若要附加至檔案，請使用 Append。 若要截斷檔案，或在檔案不存在時建立檔案，請使用 Create。

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

另請參閱