FileMode 列舉

定義

命名空間:

System.IO

組件:

System.Runtime.dll

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

public enum class FileMode

public enum FileMode

type FileMode = 

Public Enum FileMode

繼承

Object

ValueType

Enum

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 開啟，則需要 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。

另請參閱

• Open(String, FileMode)
• Open(FileMode)
• FileStream
• IsolatedStorageFileStream
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案
• 作法：讀取和寫入新建立的資料檔案