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參數是在 、 IsolatedStorageFileStream 和 方法 FileFileInfo 的許多建構 FileStream 函式中 Open 指定，以控制檔案的開啟方式。

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

適用於

另請參閱