FileMode 列舉

定義

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

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
繼承
FileMode
屬性

欄位

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 開啟,則需要 ReadWrite 使用權限。

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 的許多建構 FileStream 函式中,以及在 FileInfo 的 方法 FileOpen 指定,以控制檔案的開啟方式。

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

適用於

另請參閱