列出支持的文档格式
欢迎阅读我们关于 如何列出支持的文档格式 的完整教程，使用适用于 .NET 的 GroupDocs.Editor。无论您是在构建以文档为中心的 Web 应用还是企业级桌面工具，准确了解可以编辑或转换的格式都是必不可少的。在本指南中，您将学习如何枚举格式、解析扩展名以及编辑文档——所有内容均配有清晰、易懂的说明和可直接运行的代码片段。
快速答案
- 如何列出所有支持的格式？ 使用
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 文档”等业务规则。这也有助于只向用户展示您应用真正支持的格式。
前置条件
在开始之前，请确保您已具备以下条件：
- .NET 开发环境 – Visual Studio 2022 或任何支持 .NET 6+ 的 IDE。
- GroupDocs.Editor for .NET 库 – 从 GroupDocs 发布页面 下载。
- 临时许可证 – 获取 临时许可证 以获得无限制访问。
- 基本的 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);
}
说明：
- 遍历格式： 我们遍历所有可用的文字处理格式。
- 输出格式详情： 对每种格式打印其友好名称和默认文件扩展名。
列出演示文稿格式
Formats.PresentationFormats 对幻灯片文件的处理方式相同，通过 All 集合公开每种支持的演示文稿类型。
foreach (Formats.PresentationFormats oneFormat in Formats.PresentationFormats.All)
{
Console.WriteLine("Name is {0}, extension is {1}", oneFormat.Name, oneFormat.Extension);
}
说明：
- 遍历格式： 相同的遍历逻辑适用于演示文稿。
- 输出格式详情： 每种格式的名称和扩展名都会显示。
如何确定文件格式扩展名？
有时您只有文件名，需要推断相应的 DocumentFormat。GroupDocs.Editor 提供了一个简洁的静态帮助方法，将文件扩展名映射到内部格式表示，便于在加载到编辑器之前验证或转换文件。
解析电子表格格式
Formats.SpreadsheetFormats.FromExtension 将文件扩展名字符串转换为相应的电子表格格式枚举值。
Formats.SpreadsheetFormats expectedXlsm = Formats.SpreadsheetFormats.FromExtension(".xlsm");
Console.WriteLine("Parsed Spreadsheet format is {0}", expectedXlsm.Name);
说明：
- 解析格式：
FromExtension将.xlsm扩展名转换为内部的SpreadsheetFormat枚举。 - 输出格式： 打印解析后的格式名称，以确认映射。
解析文本格式
同样，Formats.TextualFormats.FromExtension 解析文本文件扩展名，如 HTML 或 TXT。
Formats.TextualFormats expectedHtml = Formats.TextualFormats.FromExtension("html");
Console.WriteLine("Parsed Textual format is {0}", expectedHtml.Name);
说明：
- 解析格式：
FromExtension方法将html扩展名解析为TextFormat。 - 输出格式： 显示文本格式的名称，对基于 Web 的编辑器很有用。
确定格式后如何编辑文档？
确认格式后，加载和编辑文档遵循一致的模式。首先使用源文件路径创建 Editor 实例，然后调用 Edit() 获取 EditableDocument。随后您可以读取、修改，最后使用相应的 SaveOptions 保存内容。
加载文档
Editor 是封装给定文件所有编辑操作的核心类。
using (Editor editor = new Editor("path/to/your/document.docx"))
{
// Further steps will be covered here.
}
说明：
- 初始化 Editor： 创建
Editor实例，传入目标文件的完整路径。 - 释放模式：
using语句确保及时释放所有非托管资源。
提取内容
EditableDocument.GetContent() 返回文档的原始文本（或针对基于 Web 的编辑器的 HTML），您可以对其进行显示或操作。
using (EditableDocument editableDocument = editor.Edit())
{
string content = editableDocument.GetContent();
Console.WriteLine(content);
}
说明：
- Edit 方法：
Edit()返回EditableDocument对象。 - 获取内容：
GetContent()提取文档的原始文本（或针对基于 Web 的编辑器的 HTML）。 - 输出内容： 将内容写入控制台以进行验证。
保存更改
SaveOptions 指定编辑器如何以及以何种格式将编辑后的文档写回存储。
using (EditableDocument editableDocument = editor.Edit())
{
// Modify content here
SaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
editor.Save(editableDocument, "path/to/save/document.docx", saveOptions);
}
说明：
- Edit 方法： 在修改后重新获取
EditableDocument。 - 修改内容： 对字符串进行更改（此处未展示）。
- 保存选项： 使用所需的输出格式配置
SaveOptions。 - 保存文档： 将编辑后的文件写回磁盘。
如何处理不同的文档类型？
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);
}
}
说明：
- 初始化 Editor： 将电子表格文件路径传递给
Editor构造函数。 - Edit 方法： 获取
EditableDocument。 - 获取内容： 打印电子表格的 CSV 表示（或 HTML）。
- 修改内容： 应用所需的单元格级别更改。
- 保存选项： 选择合适的
SpreadsheetSaveOptions。 - 保存文档： 将更新后的电子表格写回存储。
编辑演示文稿文档
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);
}
}
说明：
- 初始化 Editor： 通过
Editor加载 PowerPoint 文件。 - Edit 方法： 获取
EditableDocument。 - 获取内容： 提取幻灯片的 HTML 或纯文本。
- 修改内容： 更新标题、项目符号或图像。
- 保存选项： 使用
PresentationSaveOptions定义输出格式。 - 保存文档： 将编辑后的演示文稿保存。
常见问题及解决方案
- “不支持的格式”错误： 确认您使用的是最新的 GroupDocs.Editor 版本；它会定期添加对新 Office 格式的支持。
- 大文件内存消耗： 在加载文档前将
EditorSettings.EnableStreaming = true设置为启用流式模式。 - 许可证未应用： 确保临时许可证文件放置在应用程序根目录，或通过
License license = new License(); license.SetLicense("path/to/license.lic");加载。
常见问答
问：DocumentFormatInfo 与 SaveOptions 有何区别？
答：DocumentFormatInfo 提供关于支持的文件类型的元数据，而 SaveOptions 配置文档写回磁盘的方式（格式、压缩等）。
问：我可以列出自定义文件扩展名的格式吗？
答：可以——使用 DocumentFormatInfo.FromExtension("yourExt")；如果未识别该扩展名，方法返回 null。
问：GroupDocs.Editor 是否支持受密码保护的文件？
答：当然。通过 EditorSettings 将密码传递给 Editor 构造函数即可打开加密文档。
问：GroupDocs.Editor 实际支持多少种格式？
答：超过 30 种输入和输出格式，涵盖 Word、Excel、PowerPoint、HTML 和纯文本。
问：有没有办法将列表限制为仅可编辑的格式？
答：使用 GetEditableWordProcessingFormats()（或对应的 Spreadsheet/Presentation 方法）获取允许完整编辑功能的格式。
其他资源
- 从 GroupDocs 发布页面 下载库。
- 获取 临时许可证 以获得完整功能访问。
- 使用 免费试用 体验产品。
- 在 GroupDocs.Editor 文档 中查阅详细使用示例。
- 在 支持论坛 上获取社区帮助。
结论
通过本指南，您现在了解如何 列出支持的文档格式、根据扩展名确定文件格式，以及使用适用于 .NET 的 GroupDocs.Editor 编辑 Word、电子表格和演示文稿。将这些代码片段集成到自己的项目中，构建强大且具备格式感知的应用程序，提升终端用户体验并降低运行时错误。
最后更新： 2026-06-06
测试环境： GroupDocs.Editor 23.9 for .NET
作者： GroupDocs
