使用 GroupDocs.Comparison .NET 的 C# 接受文件變更 – 程式化變更管理

手動管理文件變更可能既耗時又易出錯，尤其當您需要在多位審閱者和多個修訂週期中 accept document changes c#。無論您是構建法律審核系統、內容管理平台，或任何協作編輯工具，自動化接受與拒絕變更都能節省大量手動工作，並確保可靠的稽核追蹤。

快速解答

  • “accept document changes c#” 是什麼意思？ 它指的是使用 C# 程式碼以程式化方式套用 Word、PDF 或 Excel 檔案中的選定修訂。
  • 哪個函式庫最適合處理此需求？ GroupDocs.Comparison for .NET 提供專門的 API 用於偵測、接受與拒絕變更。
  • 我需要授權嗎？ 正式環境需要臨時授權；亦提供免費試用供評估。
  • 我可以處理大型檔案嗎？ 可以 — 引擎會串流文件，能處理超過 50 MB 的檔案而無需將整個檔案載入記憶體。
  • 它是執行緒安全的嗎？ 比較引擎可在平行工作流程中使用，只要每個執行緒使用各自的文件實例即可。

GroupDocs.Comparison .NET 是什麼？

GroupDocs.Comparison .NET 是一個 .NET 函式庫，可程式化比較、合併及追蹤超過 30+ 種文件格式的修訂——包括 DOCX、PDF、XLSX、PPTX 與 HTML。它在變更偵測方面提供 99.9 % 的準確率，並在套用編輯時保留原始格式。

為什麼要以程式方式接受文件變更（C#）？

自動化接受變更可消除手動「追蹤變更」的瓶頸，將人工錯誤降低至 85 %，並提供完整且可搜尋的稽核日誌。此方法亦加速文件最終化，確保格式一致，並透過保留詳細的修訂中繼資料來支援法規遵循。具體效益包括：

  • Speed: 大量接受例行編輯可在標準 8 核心伺服器上於 30 秒內處理 1,000 頁。
  • Scalability: 使用 .NET Parallel.ForEach 時，可同時處理每分鐘最多 200 組文件。
  • Compliance: 產生符合 ISO 27001 與 GDPR 可追溯性要求的修訂報告。

可用教學

前置條件

  • .NET 6.0 或更新版本（或 .NET Framework 4.7.2+）
  • GroupDocs.Comparison for .NET NuGet 套件
  • 有效的 GroupDocs 臨時或商業授權

如何以 C# 接受文件變更 – 步驟指南

如何接受文件變更（c#）？

Comparison 是執行文件比較操作的主要類別。使用 Comparison 類別載入兩個文件版本，呼叫 Compare，然後對產生的 ComparisonResult 使用 AcceptAll。ComparisonResult 保存比較結果，包括偵測到的變更，並提供接受或拒絕變更的方法。

步驟 1：初始化比較引擎

Comparison 類別是所有比較操作的入口點。它封裝了引擎設定、檔案載入以及結果產生。

步驟 2：執行比較

使用原始檔案與修訂檔案呼叫 Compare。此方法回傳一個 ComparisonResult 物件，內含一系列 ChangeInfo 物件，代表每個偵測到的編輯。

步驟 3：定義接受規則（可選）

您可以依類型（插入、刪除、格式）或作者過濾 ChangeInfo 項目。例如，自動接受所有格式變更，同時將內容刪除標記為需手動審核。

步驟 4：接受或拒絕變更

在 ComparisonResult 上使用 AcceptAll 或 RejectAll 方法。若要套用選擇性邏輯，請遍歷 ChangeInfo 項目，對每個項目呼叫 Accept 或 Reject。

步驟 5：儲存最終文件

在 ComparisonResult 上呼叫 Save，將合併後的輸出寫入新檔案或串流。儲存的檔案會保留原始樣式、頁首、頁尾與版面配置。

定義錨點

ComparisonResult 是儲存文件比較結果的物件，包含所有偵測到的變更以及接受或拒絕變更的方法。
ChangeInfo 代表單一修訂（插入、刪除或格式），並提供作者名稱、變更類型與文件內位置等中繼資料。

效能優化技巧

  • Chunked Processing: 對於大於 50 MB 的檔案，啟用串流模式 (LoadOptions.Streaming = true) 以將記憶體使用量控制在 200 MB 以下。
  • Result Caching: 在相同文件對重複比較時，儲存 ComparisonResult 的 JSON 表示；重複使用以跳過再次比較。
  • Parallel Execution: 將批次比較包裹在 Parallel.ForEach 中，以充分利用多核心 CPU，但需確保每個執行緒使用各自的 Comparison 實例，以避免競爭條件。

LoadOptions 允許設定文件載入行為，例如串流與記憶體限制。

常見實作挑戰

處理複雜格式

當文件包含巢狀表格、註腳或嵌入物件時，某些修訂可能顯示為「合併變更」。請使用具代表性的樣本測試，並利用 ChangeInfo.IsComplex 標誌決定是否自動接受。

大檔案處理

超過 100 MB 的文件若一次性處理可能觸發 OutOfMemoryException。啟用 LoadOptions.MemoryLimit 屬性以限制記憶體使用，並強制使用暫存檔緩衝。

與現有系統整合

比較引擎會產生階層式 JSON 負載，可直接儲存於關聯式或 NoSQL 資料庫。設計資料結構時，請捕捉 ChangeInfo.Id、Author、ChangeType 與 Timestamp 以利高效查詢。

疑難排解指南

常見問題與解決方案

  • “Document format not supported” error: 確認檔案副檔名是否屬於官方文件中列出的 30+ 種支援類型。
  • Memory exceptions with large files: 切換至串流模式，並提升 LoadOptions.MemoryLimit 設定。
  • Slow performance on bulk jobs: 啟用平行處理並快取中間的 ComparisonResult 物件。

ComparisonException 會在比較引擎遇到錯誤時拋出。

整合技巧

  • Database Integration: 將 ComparisonResult 儲存為 JSON 欄位，並為 Author 與 ChangeType 欄位建立索引，以加速稽核查詢。
  • API Design: 提供如 /api/compare 與 /api/accept 的端點，接受檔案串流並回傳狀態 URL 以供非同步處理。
  • Error Handling: 將所有檔案 I/O 與比較呼叫包裹於 try‑catch 區塊，記錄 ComparisonException 詳細資訊以便排錯。

進階工作流程情境

自動化審核工作流程

// Example workflow logic (conceptual)
foreach (var change in detectedChanges)
{
    if (change.Type == ChangeType.Formatting && change.Severity == "Minor")
    {
        // Auto-accept minor formatting changes
        change.Accept();
    }
    else if (change.Type == ChangeType.Content && change.Author != "TrustedEditor")
    {
        // Route content changes to manual review
        SendToReviewQueue(change);
    }
}

條件式變更處理

實作業務規則，自動接受例行拼寫校正，同時將合約條款的修改導向法律審核員。此混合方式可最大化效率並維持合規性。

後續步驟

首先克隆 Accept and Reject Edits 教學，然後試驗上述的選擇性接受模式。對於正式部署，請考慮：

  • 為每次接受/拒絕操作啟用結構化日誌（例如 Serilog）。
  • 設定健康檢查，以監控比較服務的記憶體佔用情況。
  • 設計回滾機制，從版本控制的儲存庫還原原始文件。

其他資源

最後更新： 2026-07-01
測試環境： GroupDocs.Comparison 23.12 for .NET
作者： GroupDocs

相關教學