CodeGym /課程 /C# SELF /實例類別 FileInfo 和 DirectoryInfo

實例類別 FileInfo 和 DirectoryInfo

C# SELF
等級 39, 課堂 1
開放

1. 介紹

如果把靜態類別,例如 File 和 Directory 比作萬用瑞士刀:隨手可得、能快速解決問題,但不綁定到某個具體物件,那麼 FileInfo 和 DirectoryInfo 就像是為某個檔案或資料夾量身打造的工具:它們為特定檔案/資料夾建立,知道很多關於它們的資訊,並且在對同一個物件進行多次操作時更方便、更靈活。

實例類別 保存了關於特定檔案系統物件的細節,而且在第一次載入屬性後(只要物件沒過期),不一定要每次都去檔案系統讀取資訊。

  • FileInfo — 用來操作特定檔案。
  • DirectoryInfo — 用來操作特定目錄(資料夾)。

它們包含可以取得詳細資訊(大小、建立時間、副檔名、可用屬性)並對檔案/資料夾執行各種操作的屬性和方法:複製、刪除、移動等等。

FileInfo 和 DirectoryInfo 的結構

兩個類別都繼承自共同的抽象類別 FileSystemInfo,這讓你能寫出同時處理檔案和資料夾的通用程式碼。


System.Object
   |
System.MarshalByRefObject
   |
System.IO.FileSystemInfo (抽象類別)
   |             |
  FileInfo    DirectoryInfo

什麼時候該使用實例類別?

  • 需要對同一個檔案/資料夾取得大量資訊(大小、最後修改時間、副檔名、屬性等),且這些資料會被重複使用時。
  • 要列舉目錄中所有檔案/資料夾,並把每個物件當成「活生生的」實例來處理時。
  • 為了優化,避免不必要地多次訪問檔案系統(使用快取)。
  • 想寫更物件導向的程式碼(備份、媒體庫、檔案管理器等情境)。

如何建立 FileInfo 或 DirectoryInfo

using System.IO;

// 為一個存在(或不存在!)的檔案建立 FileInfo 物件:
var fileInfo = new FileInfo("notes.txt");

// 為資料夾建立 DirectoryInfo:
var dirInfo = new DirectoryInfo(@"C:\Projects");

// 可以使用相對或絕對路徑!

重要:建立 FileInfo 或 DirectoryInfo 物件並不會在檔案系統中建立檔案/資料夾!它只是描述(建立一個參考)。

2. 使用 FileInfo

我們來看這個類別的主要屬性和方法。備忘如下:

屬性/方法 回傳什麼? 使用範例
Name
檔名
fileInfo.Name
FullName
完整路徑
fileInfo.FullName
Length
檔案大小(位元組)
fileInfo.Length
Directory
父目錄(DirectoryInfo)
fileInfo.Directory.FullName
Exists
檔案是否真實存在?
fileInfo.Exists
Extension
檔案副檔名(例如 .txt)
fileInfo.Extension
CreationTime
建立時間
fileInfo.CreationTime
LastWriteTime
最後修改時間
fileInfo.LastWriteTime
IsReadOnly
是否唯讀?
fileInfo.IsReadOnly
方法
CopyTo()
複製檔案
fileInfo.CopyTo("copy.txt")
Delete()
刪除檔案
fileInfo.Delete()
MoveTo()
移動檔案
fileInfo.MoveTo("move.txt")
OpenRead()
開啟讀取串流
using var stream = fileInfo.OpenRead()
OpenWrite()
開啟寫入串流
using var stream = fileInfo.OpenWrite()

範例:檔案資訊

我們加一個小模組,使用 FileInfo 取得檔案的詳細資訊。

Console.WriteLine("Vvedite imya faila:");
string fileName = Console.ReadLine();

var file = new FileInfo(fileName);
if (file.Exists)
{
    Console.WriteLine($"Imya faila: {file.Name}");
    Console.WriteLine($"Put': {file.FullName}");
    Console.WriteLine($"Razmer: {file.Length} bayt");
    Console.WriteLine($"Rasshirenie: {file.Extension}");
    Console.WriteLine($"Data sozdaniya: {file.CreationTime}");
    Console.WriteLine($"Poslednee izmenenie: {file.LastWriteTime}");

    // Doplnitel'no: pokazat' roditel'skuyu direktoriyu
    Console.WriteLine($"Roditelskaya papka: {file.DirectoryName}");
}
else
{
    Console.WriteLine("Fail ne nayden.");
}

注意:我們不是去讀檔案內容,只是獲取元資料。

練習:複製和刪除檔案

// ... Vnutri osnovnogo metoda posle uspeshnogo vyvoda svedeniy o fayle:
Console.WriteLine("Vvedite put' dlya kopii faila:");
string copyPath = Console.ReadLine();

try
{
    file.CopyTo(copyPath);
    Console.WriteLine($"Fayl uspeshno skopirovan v {copyPath}");
}
catch (IOException ex)
{
    Console.WriteLine($"Ne udalos' skopirovat' fayl: {ex.Message}");
}

// Teper' udalim kopiyu
Console.WriteLine("Udalyit' kopiyu faila? (y/n):");
if (Console.ReadLine().Trim().ToLower() == "y")
{
    var copyFile = new FileInfo(copyPath);
    if (copyFile.Exists)
    {
        copyFile.Delete();
        Console.WriteLine("Kopiya udalena.");
    }
}

3. 使用 DirectoryInfo

來看看 DirectoryInfo 能帶來什麼:

屬性/方法 回傳什麼? 使用範例
Name
資料夾名稱
dirInfo.Name
FullName
完整路徑
dirInfo.FullName
Parent
父資料夾(DirectoryInfo)
dirInfo.Parent.FullName
Exists
資料夾是否存在?
dirInfo.Exists
CreationTime
建立時間
dirInfo.CreationTime
LastWriteTime
修改時間
dirInfo.LastWriteTime
方法
Create()
建立資料夾
dirInfo.Create()
Delete()
刪除資料夾
dirInfo.Delete()
GetFiles()
檔案陣列(FileInfo 陣列)
dirInfo.GetFiles()
GetDirectories()
子資料夾陣列(DirectoryInfo 陣列)
dirInfo.GetDirectories()
EnumerateFiles()
列舉檔案(回傳 IEnumerable<FileInfo>,延遲執行)
dirInfo.EnumerateFiles()
MoveTo()
移動資料夾
dirInfo.MoveTo("path")

範例:列舉檔案和資料夾

Console.WriteLine("Vvedite put' k papke:");
string path = Console.ReadLine();

var dir = new DirectoryInfo(path);
if (!dir.Exists)
{
    Console.WriteLine("Papka ne naydena!");
    return;
}

Console.WriteLine("\n--- Fayly ---");
foreach (var file in dir.GetFiles())
{
    Console.WriteLine($"{file.Name} ({file.Length} bayt)");
}

Console.WriteLine("\n--- Podpapki ---");
foreach (var subDir in dir.GetDirectories())
{
    Console.WriteLine(subDir.Name);
}

4. 有用的細節

靜態方法 vs 實例類別

何時使用哪種方式?如果你要做一個快速的「一次性」操作——例如 File.Exists(path) 或 File.ReadAllText(path),靜態方法通常更合適。它們簡單,因為開銷更小,速度也稍快。

但如果你想獲取很多關於檔案或資料夾的資訊、對該物件重複執行操作,或者想以 OOP 風格寫程式,那就用實例 FileInfo 和 DirectoryInfo 更好。

有趣的是,兩者在底層都會呼叫類似的系統 API。但實例類別會快取某些屬性(大小、時間、屬性),減少對檔案系統的存取次數——在大量檔案的情況下特別有感。

跟時間和日期有關的小提醒

屬性 CreationTime, LastWriteTime, LastAccessTime 都回傳 DateTime 型別。

Console.WriteLine($"Fayl sozdana: {file.CreationTime:yyyy-MM-dd HH:mm:ss}");
Console.WriteLine($"Poslednee izmenenie: {file.LastWriteTime:yyyy-MM-dd HH:mm:ss}");

如果檔案或資料夾在你建立 FileInfo 或 DirectoryInfo 之後被外部改動,快取的資訊可能會過時。要更新,請呼叫 file.Refresh()。

建議與實務經驗

  • 當你建立檔案系統的包裝層(備份、媒體庫、索引器)時,實例類別很方便。
  • 它們和 LINQ 很搭:可以根據大小、日期或副檔名過濾,然後對選中的物件執行操作。
  • 大量操作時,優先考慮 EnumerateFiles() 和 EnumerateDirectories(),而不是 GetFiles()/GetDirectories()——延遲列舉可以節省記憶體並加快處理啟動速度。

靜態與實例方法比較

靜態方法 實例類別
語法
File.Delete(path)
new FileInfo(path).Delete()
快取 沒有 有
大量資訊 需要呼叫很多方法 物件裡就有
OO 風格 沒有 有
大規模操作 不方便 方便
串流操作 有 有

更新資訊與物件

FileInfo/DirectoryInfo 物件在第一次存取屬性後會快取值。如果檔案或資料夾在建立實例後被改變,要更新資訊請呼叫 .Refresh()。

var file = new FileInfo("notes.txt");
long oldSize = file.Length;

// V etot moment kto-to (ili vy sami) menyayet fayl vne programmy

file.Refresh();
long newSize = file.Length;

這種情況不常見,但如果你的程式在監視檔案系統,這個機制很重要。

5. 使用實例類別時的常見錯誤

迷思:如果建立了 new FileInfo("file.txt"),意思是檔案已存在。事實上不是這樣——只有在你實際寫入檔案或呼叫 Create() 時,檔案才會出現。

試圖取得不存在檔案的屬性:有些屬性會回傳預設值(例如大小會是 0),但嘗試打開讀取串流會拋出例外。

資料夾也是同理:建立 DirectoryInfo 並不保證資料夾在磁碟上存在,除非你呼叫 Create() 或它實際建立。

2
任務
C# SELF, 等級 39, 課堂 1
上鎖
列出目錄中的檔案
列出目錄中的檔案
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION