列出支援的文件格式

歡迎閱讀我們關於 如何列出支援的文件格式 的完整教學，使用 GroupDocs.Editor for .NET。無論您是構建以文件為中心的網頁應用程式，還是企業級桌面工具，精確了解可以編輯或轉換的格式都是必須的。在本指南中，您將學會如何列舉格式、解析副檔名，並編輯文件——全部以清晰、易於理解的說明和可直接執行的程式碼片段呈現。

快速回答

  • 如何列出所有支援的格式？ 使用 DocumentFormatInfo.GetSupportedWordProcessingFormats()（或 Presentation/Spreadsheet 等效方法）並遍歷集合。
  • 我可以從檔案副檔名判斷格式嗎？ 可以——呼叫 DocumentFormatInfo.FromExtension(".docx")。
  • GroupDocs.Editor 支援哪些檔案類型？ 超過 30 種輸入與輸出格式，包括 DOCX、XLSX、PPTX、HTML 以及純文字。
  • 列出格式需要授權嗎？ 臨時授權可解鎖完整 API；否則試用版僅提供有限功能。
  • 相容的 .NET 版本有哪些？ .NET Framework 4.6+、.NET Core 3.1+、.NET 5/6/7。

什麼是「列出支援的文件格式」？

此詞語指以程式方式取得 GroupDocs.Editor 能開啟、編輯與儲存的檔案類型集合。此操作可讓您建立動態 UI 下拉選單或在處理前驗證使用者上傳的檔案，確保僅將相容的檔案傳遞給編輯器進行後續操作。

為什麼要列出支援的文件格式？

GroupDocs.Editor 支援超過 30 種輸入與輸出格式，且可處理高達 2 GB 的檔案，而無需將整個文件載入記憶體。了解確切的格式清單可防止執行時錯誤、提升使用者體驗，並讓您能實施如「僅允許可編輯的 Office 文件」等業務規則。它同時協助您只向使用者顯示應用程式實際支援的格式。

前置條件

  1. .NET 開發環境 – Visual Studio 2022 或任何支援 .NET 6+ 的 IDE。
  2. GroupDocs.Editor for .NET 程式庫 – 從 GroupDocs releases page 下載。
  3. 臨時授權 – 取得 temporary license 以獲得完整存取權限。
  4. 基本 C# 知識 – 熟悉命名空間、using 陳述式與主控台輸出。

如何列出支援的文件格式？

載入支援的格式集合，並印出每個格式的名稱與副檔名。此兩步驟模式適用於文字處理、試算表與簡報文件。透過遍歷集合，您可以動態填充 UI 元件（如下拉選單），確保使用者只能選取編輯器實際能處理的格式。

// No actual code block – placeholder retained from original tutorial
```csharp
using System;
using GroupDocs.Editor.Options;

列出文字處理格式

Formats.WordProcessingFormats 是一個列舉，描述編輯器所識別的每種文字處理檔案類型。All 屬性會回傳這些格式物件的集合。

foreach (Formats.WordProcessingFormats oneFormat in Formats.WordProcessingFormats.All)
{
    Console.WriteLine("Name is {0}, extension is {1}", oneFormat.Name, oneFormat.Extension);
}

說明：

  1. 遍歷格式： 我們遍歷所有可用的文字處理格式。
  2. 輸出格式細節： 對每個格式，我們印出其友好名稱與預設副檔名。

列出簡報格式

Formats.PresentationFormats 以相同方式處理投影片檔案，透過 All 集合揭示每種支援的簡報類型。

foreach (Formats.PresentationFormats oneFormat in Formats.PresentationFormats.All)
{
    Console.WriteLine("Name is {0}, extension is {1}", oneFormat.Name, oneFormat.Extension);
}

說明：

  1. 遍歷格式： 相同的遍歷邏輯適用於簡報。
  2. 輸出格式細節： 每個格式的名稱與副檔名皆會顯示。

如何判斷檔案格式副檔名？

有時您只有檔名，需要推斷相應的 DocumentFormat。GroupDocs.Editor 提供簡單的靜態輔助方法，將檔案副檔名映射到內部格式表示，讓您在載入編輯器前驗證或轉換檔案。

解析試算表格式

Formats.SpreadsheetFormats.FromExtension 會將檔案副檔名字串轉換為相對應的試算表格式列舉值。

Formats.SpreadsheetFormats expectedXlsm = Formats.SpreadsheetFormats.FromExtension(".xlsm");
Console.WriteLine("Parsed Spreadsheet format is {0}", expectedXlsm.Name);

說明：

  1. 解析格式： FromExtension 將 .xlsm 副檔名轉換為其內部的 SpreadsheetFormat 列舉。
  2. 輸出格式： 印出解析後的格式名稱，以確認映射正確。

解析文字格式

同樣地，Formats.TextualFormats.FromExtension 解析文字檔案的副檔名，例如 HTML 或 TXT。

Formats.TextualFormats expectedHtml = Formats.TextualFormats.FromExtension("html");
Console.WriteLine("Parsed Textual format is {0}", expectedHtml.Name);

說明：

  1. 解析格式： FromExtension 方法將 html 副檔名解析為 TextFormat。
  2. 輸出格式： 顯示文字格式的名稱，對於基於網頁的編輯器很有用。

確認格式後如何編輯文件？

一旦知道格式，載入與編輯文件遵循一致的模式。首先以來源檔案路徑建立 Editor 實例，然後呼叫 Edit() 取得 EditableDocument。接著您可以讀取、修改，最後使用相應的 SaveOptions 儲存內容。

載入文件

Editor 是封裝特定檔案所有編輯操作的核心類別。

using (Editor editor = new Editor("path/to/your/document.docx"))
{
    // Further steps will be covered here.
}

說明：

  1. 初始化 Editor： 建立 Editor 實例，傳入目標檔案的完整路徑。
  2. 釋放模式： using 陳述式確保所有非受控資源即時釋放。

取得內容

EditableDocument.GetContent() 會回傳文件的原始文字（或對於基於網頁的編輯器則為 HTML），您可以顯示或操作它。

using (EditableDocument editableDocument = editor.Edit())
{
    string content = editableDocument.GetContent();
    Console.WriteLine(content);
}

說明：

  1. Edit 方法： Edit() 回傳 EditableDocument 物件。
  2. 取得內容： GetContent() 取得文件的原始文字（或對於基於網頁的編輯器則為 HTML）。
  3. 輸出內容： 將內容寫入主控台以供驗證。

儲存變更

SaveOptions 告訴編輯器如何以及以何種格式將編輯後的文件寫回儲存。

using (EditableDocument editableDocument = editor.Edit())
{
    // Modify content here
    SaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
    editor.Save(editableDocument, "path/to/save/document.docx", saveOptions);
}

說明：

  1. Edit 方法： 在修改後重新取得 EditableDocument。
  2. 修改內容： 對字串套用變更（此處未示範）。
  3. 儲存選項： 使用所需的輸出格式設定 SaveOptions。
  4. 儲存文件： 將編輯後的檔案寫回磁碟。

如何處理不同類型的文件？

GroupDocs.Editor 把 Word、試算表與簡報的處理抽象為相同的 API 介面，讓您無需為每種文件族群學習新類別，即可輕鬆切換使用情境。

編輯試算表文件

SpreadsheetSaveOptions 定義試算表的寫入方式，包括格式與可選的壓縮設定。

using (Editor editor = new Editor("path/to/your/spreadsheet.xlsx"))
{
    using (EditableDocument editableDocument = editor.Edit())
    {
        string content = editableDocument.GetContent();
        Console.WriteLine(content);
        // Modify content here
        SaveOptions saveOptions = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx);
        editor.Save(editableDocument, "path/to/save/spreadsheet.xlsx", saveOptions);
    }
}

說明：

  1. 初始化 Editor： 將試算表檔案路徑傳入 Editor 建構函式。
  2. Edit 方法： 取得 EditableDocument。
  3. 取得內容： 印出試算表的 CSV 表示（或 HTML）。
  4. 修改內容： 套用您需要的儲存格層級變更。
  5. 儲存選項： 選擇適當的 SpreadsheetSaveOptions。
  6. 儲存文件： 將更新後的試算表寫回儲存。

編輯簡報文件

PresentationSaveOptions 控制投影片的輸出格式，讓您可以保留或變更原始檔案類型。

using (Editor editor = new Editor("path/to/your/presentation.pptx"))
{
    using (EditableDocument editableDocument = editor.Edit())
    {
        string content = editableDocument.GetContent();
        Console.WriteLine(content);
        // Modify content here
        SaveOptions saveOptions = new PresentationSaveOptions(PresentationFormats.Pptx);
        editor.Save(editableDocument, "path/to/save/presentation.pptx", saveOptions);
    }
}

說明：

  1. 初始化 Editor： 透過 Editor 載入 PowerPoint 檔案。
  2. Edit 方法： 取得 EditableDocument。
  3. 取得內容： 抽取投影片的 HTML 或純文字。
  4. 修改內容： 更新標題、項目符號或圖片。
  5. 儲存選項： 使用 PresentationSaveOptions 定義輸出格式。
  6. 儲存文件： 將編輯後的簡報儲存。

常見問題與解決方案

  • 「不支援的格式」錯誤： 確認您使用的是最新的 GroupDocs.Editor 版本；它會定期加入對新 Office 格式的支援。
  • 大型檔案記憶體消耗： 在載入文件前將 EditorSettings.EnableStreaming = true 以啟用串流模式。
  • 授權未套用： 確認臨時授權檔案放置於應用程式根目錄，或透過 License license = new License(); license.SetLicense("path/to/license.lic"); 載入。

常見問答

Q: DocumentFormatInfo 與 SaveOptions 有何差異？
A: DocumentFormatInfo 提供支援檔案類型的中繼資料，而 SaveOptions 設定文件寫回磁碟的方式（格式、壓縮等）。

Q: 我可以列出自訂副檔名的格式嗎？
A: 可以——使用 DocumentFormatInfo.FromExtension("yourExt")；若副檔名未被識別，該方法會回傳 null。

Q: GroupDocs.Editor 支援受密碼保護的檔案嗎？
A: 當然支援。透過 EditorSettings 將密碼傳入 Editor 建構函式，即可開啟加密文件。

Q: GroupDocs.Editor 實際支援多少種格式？
A: 超過 30 種輸入與輸出格式，涵蓋 Word、Excel、PowerPoint、HTML 與純文字。

Q: 有沒有方法將清單限制為僅可編輯的格式？
A: 使用 GetEditableWordProcessingFormats()（或 Spreadsheet/Presentation 等效方法）取得允許完整編輯功能的格式。

其他資源

結論

透過本指南，您現在已了解如何 列出支援的文件格式、從副檔名判斷檔案格式，以及使用 GroupDocs.Editor for .NET 編輯 Word、試算表與簡報類型的文件。將這些程式碼片段整合至您的專案，以打造具備格式感知的穩健應用程式，提升終端使用者體驗並減少執行時錯誤。

最後更新： 2026-06-06
測試環境： GroupDocs.Editor 23.9 for .NET
作者： GroupDocs

相關教學