CodeGym /課程 /C# SELF /檔案開啟模式

檔案開啟模式

C# SELF
等級 35, 課堂 4
開放

1. 前言

當你用 FileStream 或其他串流類別操作檔案時,事先搞懂開檔時到底會發生什麼事超重要。常常遇到檔案已經存在,你想要加資料但不想把舊的蓋掉,或是你就是要整個重寫檔案。還有時候檔案根本還沒建立,你只想讀,不想不小心弄出個空檔案。

舉例來說,如果你在寫一個日記本,目標就是把新內容加到已經存在的檔案最後面,保留所有舊資料。這時你就要用新增模式開檔。如果是 log 檔,每次啟動 app 都要重來,舊資料不能干擾新的,這時就要開檔時直接清空或沒檔案就新建。要是你只是想讀檔,通常會希望沒檔案時不要自動新建,不然會莫名其妙多個空檔案。

這些不同情境——新增、覆寫、只讀不新建——在 C# 裡都是靠 System.IO.FileMode 列舉來搞定的。每個模式都決定開檔或建檔時的行為,讓你能精準控制跟檔案互動時會發生什麼事。

2. FileMode 列舉——白話解釋

這裡是 FileMode 列舉的主要值:

值 說明 檔案已存在時 檔案不存在時
CreateNew
建立新檔案。如果檔案已存在——會丟出例外 錯誤 OK,檔案建立
Create
如果沒有就建立新檔,有的話就覆寫掉 覆寫 OK,建立
Open
開啟已存在檔案。沒檔案——丟例外 OK,開啟 錯誤
OpenOrCreate
有就開,沒有就新建 OK,開啟 OK,建立
Truncate
開啟已存在檔案並清空內容(長度歸零) OK,清空檔案 錯誤
Append
開啟檔案在最後面加資料,沒檔案就新建 OK,加在最後 OK,建立

圖解:各種情境行為


flowchart TD
    Start[開始]
    A{檔案存在嗎?}
    B1[開啟新增]
    B2[建立新檔]
    B3[覆寫檔案]
    B4[開啟檔案]
    B5[錯誤:找不到檔案]
    B6[錯誤:檔案已存在]

    Start --> A
    A --Append, OpenOrCreate--> B1
    A --Create, Truncate--> B3
    A --Open, Truncate--> B4
    A --CreateNew--> B6
    A --Create, OpenOrCreate, Append--> B2
    A --Open, Truncate--> B5
FileMode 不同模式的行為情境

3. 各種模式開檔範例

來實作一下,假設我們有個小 app,要把問候語和日期寫進一個文字檔。我們看三種常見情境:

  • A. 建立新檔案 (CreateNew)
  • B. 覆寫檔案 (Create)
  • C. 在檔案最後加資料 (Append)

建立新檔案 (FileMode.CreateNew)

如果檔案已經存在,這個模式保證你不能重建:程式會丟出 IOException。適合不能遺失資料或不想誤刪別人檔案的情境。

using System;
using System.IO;

string filePath = "greeting.txt";

// 嘗試建立新檔案——如果已經有會丟例外!
try
{
    var stream = new FileStream(filePath, FileMode.CreateNew, FileAccess.Write);
    var writer = new StreamWriter(stream);
    
    writer.WriteLine("哈囉!這是第一筆紀錄。");
    writer.WriteLine($"日期:{DateTime.Now}");
    
    Console.WriteLine("檔案建立成功。");   
    writer.Close();
}
catch (IOException)
{
    Console.WriteLine($"檔案 '{filePath}' 已經存在!不會覆寫它。");
}

注意:如果你第二次跑這段 code——catch 會觸發,資料不會被蓋掉。

覆寫檔案 (FileMode.Create)

這模式完全不囉嗦:有檔案就直接清空。沒檔案就新建。很適合每次都要「從零開始」的情境,比如重存報表。

using System;
using System.IO;

string filePath = "greeting.txt";

// 建立或完全覆寫檔案
var stream = new FileStream(filePath, FileMode.Create, FileAccess.Write);
var writer = new StreamWriter(stream);

writer.WriteLine("哈囉!我把檔案整個更新了 :)");
writer.WriteLine($"更新時間:{DateTime.Now}");

Console.WriteLine("檔案已建立或覆寫。");
writer.Close();

多跑幾次這段 code——檔案裡永遠只有最新的資料,舊的都沒了。

在檔案最後加資料 (FileMode.Append)

這模式超適合 log、事件紀錄、打卡等等。沒檔案就新建,有的話就加在最後。

using System;
using System.IO;

string filePath = "greeting.txt";

// 在檔案最後加新的一行
var stream = new FileStream(filePath, FileMode.Append, FileAccess.Write);
var writer = new StreamWriter(stream);

writer.WriteLine($"又一個問候!日期:{DateTime.Now}");

Console.WriteLine("已在檔案最後加新的一行。");
writer.Close();

多跑幾次這段 code,檔案會越來越長,每次新資料都在最後。

4. 怎麼選檔案開啟模式?實用建議

真實世界情境:

  • Log 紀錄:幾乎都用 Append。log 被覆寫掉會讓管理員崩潰,也方便壞人滅證。
  • 報表匯出:通常用 Create,避免資料夾堆一堆舊檔。
  • 重要資料匯出:適合 CreateNew。有檔案就錯誤,什麼都不動。
  • 讀檔:根本不需要建檔模式,用 FileMode.Open——沒檔案就代表有問題。

寫 C# code 時常用 File 類別的靜態方法,這些方法內部會自動選對的模式。例如 File.AppendAllText 永遠用 Append,File.WriteAllText 則用 Create。

5. 檔案模式與常見問題

有幾個小陷阱:

如果你用 FileMode.Create 或 FileMode.Truncate 開檔,所有內容都會被清空。要小心——不小心遺失資料的,不只新手,連老鳥都會中招。

如果你用 FileMode.Open 或 FileMode.Truncate 開不存在的檔案,會拿到 FileNotFoundException。記得用 File.Exists(path) 先檢查檔案真的有沒有。

用 Append 只能寫,不能讀。如果你要又讀又寫,可以考慮 OpenOrCreate + 對應的 FileAccess。

範例:讀寫同時進行

有時候你想又讀又寫(比如開銀行帳戶——要存錢也要查餘額)。用 FileMode.OpenOrCreate:

using System.IO;

string filePath = "balance.txt";

// 開檔可讀可寫,沒檔案就新建
var stream = new FileStream(filePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);
// 這裡可以又讀又寫

6. 實用細節

檔案開啟模式流程


graph TD
    A[請求檔案] --> B[選擇模式]
    B --> C1[CreateNew] -->|檔案已存在| D1[錯誤]
    C1 -->|檔案不存在| E1[建立]
    B --> C2[Create] -->|永遠| F1[建立/覆寫]
    B --> C3[Open] -->|檔案存在| G1[開啟]
    C3 -->|檔案不存在| D1
    B --> C4[OpenOrCreate] -->|檔案存在| G1
    C4 -->|檔案不存在| E1
    B --> C5[Append] -->|檔案存在| H1[開啟新增]
    C5 -->|檔案不存在| E1
    B --> C6[Truncate] -->|檔案存在| I1[清空]
    C6 -->|檔案不存在| D1
檔案開啟模式決策流程圖

檔案開啟模式總表

FileMode 檔案存在 檔案不存在 資料存取 會清空舊內容?
CreateNew
例外 新建 寫入 不適用
Create
覆寫 新建 寫入 會
Open
開啟 例外 讀/寫 不會
OpenOrCreate
開啟 新建 讀/寫 不會
Truncate
清空 例外 寫入 會
Append
開啟新增 新建 只能寫 不會(加在後面)

跟 File 類別高階方法的比較

  • File.WriteAllText(path, text) → 內部用 FileMode.Create,所以舊檔會被覆寫。
  • File.AppendAllText(path, text) → 用 Append,全部加在最後。
  • File.ReadAllText(path) → 開檔讀取(FileMode.Open)。

有時這些方法就夠用,但用 FileStream 明確指定模式會讓你完全掌控一切。

不同作業系統的注意事項

很多開發者沒注意到,在 Windows 上如果檔案被別的程式用寫入模式開著,可能就不能再開一次——會直接錯誤。所以要正確用 FileShare 參數來管理檔案共用(這個我們之後會再細講)。不同作業系統的鎖定和權限機制可能不一樣,但檔案開啟模式的概念是通用的。

2
任務
C# SELF, 等級 35, 課堂 4
上鎖
在檔案結尾新增內容
在檔案結尾新增內容
1
問卷/小測驗
檔案操作,等級 35,課堂 4
未開放
檔案操作
C# 檔案操作基礎
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION