萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET (C#) 檔案操作完整工具類:讀寫、複製、移動、刪除、目錄管理

前言

System.IO 命名空間提供豐富的檔案與目錄操作 API。本文整理一個生產級 FileHelper 靜態工具類,涵蓋讀寫、附加、複製、移動、刪除、目錄建立/遞歸刪除、編碼處理等常用功能,並採用 using 確保資源正確釋放。

完整工具類程式碼

using System;
using System.IO;
using System.Text;

public static class FileHelper
{
    #region 寫入檔案(不存在則建立,預設 UTF-8)
    /// 寫入文字檔(覆寫模式)
    public static void WriteFile(string path, string content, Encoding encoding = null)
    {
        encoding ??= Encoding.UTF8;
        var dir = Path.GetDirectoryName(path);
        if (!string.IsNullOrEmpty(dir) && !Directory.Exists(dir))
            Directory.CreateDirectory(dir);

        File.WriteAllText(path, content, encoding);
    }

    /// 附加文字到檔案末尾
    public static void AppendFile(string path, string content, Encoding encoding = null)
    {
        encoding ??= Encoding.UTF8;
        File.AppendAllText(path, content, encoding);
    }
    #endregion

    #region 讀取檔案
    /// 讀取全文(自動偵測編碼或指定編碼)
    public static string ReadFile(string path, Encoding encoding = null)
    {
        if (!File.Exists(path)) return string.Empty;
        encoding ??= Encoding.UTF8;
        return File.ReadAllText(path, encoding);
    }

    /// 逐行讀取(大檔案節省記憶體)
    public static IEnumerable ReadLines(string path, Encoding encoding = null)
    {
        encoding ??= Encoding.UTF8;
        using var reader = new StreamReader(path, encoding);
        string line;
        while ((line = reader.ReadLine()) != null) yield return line;
    }
    #endregion

    #region 複製、移動、刪除
    public static void CopyFile(string source, string dest, bool overwrite = true)
    {
        var destDir = Path.GetDirectoryName(dest);
        if (!string.IsNullOrEmpty(destDir) && !Directory.Exists(destDir))
            Directory.CreateDirectory(destDir);
        File.Copy(source, dest, overwrite);
    }

    public static void MoveFile(string source, string dest)
    {
        var destDir = Path.GetDirectoryName(dest);
        if (!string.IsNullOrEmpty(destDir) && !Directory.Exists(destDir))
            Directory.CreateDirectory(destDir);
        File.Move(source, dest);
    }

    public static void DeleteFile(string path)
    {
        if (File.Exists(path)) File.Delete(path);
    }
    #endregion

    #region 目錄操作
    public static void EnsureDirectory(string path)
    {
        if (!Directory.Exists(path)) Directory.CreateDirectory(path);
    }

    /// 遞歸刪除目錄及所有內容
    public static void DeleteDirectory(string path, bool recursive = true)
    {
        if (Directory.Exists(path))
            Directory.Delete(path, recursive);
    }

    /// 取得目錄下所有檔案(含子目錄,可篩選副檔名)
    public static string[] GetFiles(string path, string searchPattern = "*.*", SearchOption option = SearchOption.AllDirectories)
    {
        return Directory.Exists(path) ? Directory.GetFiles(path, searchPattern, option) : Array.Empty();
    }
    #endregion

    #region 進階:串流複製大檔案(避免記憶體暴增)
    public static void CopyStream(string source, string dest, int bufferSize = 81920)
    {
        using var src = File.OpenRead(source);
        using var dst = File.Create(dest);
        src.CopyTo(dst, bufferSize);
    }
    #endregion

    #region 輔助:取得副檔名
    public static string GetExtension(string fileName) => Path.GetExtension(fileName)?.ToLowerInvariant();
    #endregion
}

使用範例

// 寫入/附加
FileHelper.WriteFile(@"C:\Data\log.txt", "第一行\n");
FileHelper.AppendFile(@"C:\Data\log.txt", "第二行\n");

// 讀取
string all = FileHelper.ReadFile(@"C:\Data\log.txt");
foreach (var line in FileHelper.ReadLines(@"C:\Data\log.txt"))
    Console.WriteLine(line);

// 複製/移動/刪除
FileHelper.CopyFile(@"C:\Data\a.txt", @"C:\Backup\a.txt");
FileHelper.MoveFile(@"C:\Data\b.txt", @"C:\Archive\b.txt");
FileHelper.DeleteFile(@"C:\Data\old.tmp");

// 目錄
FileHelper.EnsureDirectory(@"C:\NewFolder\Sub");
FileHelper.DeleteDirectory(@"C:\Temp", recursive: true);
var csFiles = FileHelper.GetFiles(@"C:\Project", "*.cs");

最佳實踐提醒

  • 編碼統一用 UTF-8:避免 Big5/GB2312 造成跨平台亂碼,僅在舊系統整合時指定編碼。
  • 大檔案用串流:File.ReadAllText 會一次載入記憶體,超過 100MB 建議 StreamReader 逐行或 CopyStream。
  • 路徑處理用 Path 類別:Path.Combine、GetDirectoryName、GetFileName 跨平台安全。
  • 非同步版本:.NET Core / 4.5+ 提供 ReadAllTextAsync、CopyToAsync,UI 應用必須使用避免凍結。
  • 例外處理:工具類建議拋出例外讓上層決定重試/記錄/顯示,不要吞沒例外。

結語

封裝良好的 FileHelper 能大幅減少專案中重複的 IO 代碼,並統一編碼、錯誤處理與資源釋放策略。隨著 .NET 版本演進,優先使用 File. 靜態便利方法與非同步 API,僅在需精細控制串流時才直接操作 FileStream/StreamReader。

copyright © 萬盛學電腦網 all rights reserved