在 .NET 中使用 GroupDocs.Redaction 显示受支持的文件格式

管理各种文档类型是 .NET 开发人员的日常现实。通过使用 GroupDocs.Redaction，您可以 列出文件扩展名，了解库支持的文件类型，从而使您的应用能够智能地接受或拒绝上传，提供友好的 UI 选项，并避免代价高昂的运行时错误。本教程将带您了解所需的一切——从先决条件到完整的生产就绪实现——让您能够自信地 获取文件格式 并在解决方案中 c# 显示文件格式。

快速答案

  • “列出文件扩展名” 是什么意思？ 它意味着从 API 检索受支持的文件类型标识符集合（例如 .pdf、.docx）。
  • 哪个 NuGet 包提供此功能？ GroupDocs.Redaction（最新稳定版）。
  • 运行示例是否需要许可证？ 免费试用许可证可用于开发；生产环境需要永久许可证。
  • 我可以缓存结果吗？ 可以——将列表存储在内存或分布式缓存中，以避免重复的 API 调用。
  • 此功能是否兼容 .NET 6 和 .NET Core？ 当然；该库支持 .NET Framework 4.5+、.NET Core 3.1+、.NET 5+ 和 .NET 6+。

什么是 GroupDocs.Redaction？

GroupDocs.Redaction 是一个 .NET 库，使开发人员能够对敏感内容进行马赛克处理、转换文档并发现受支持的文件类型——无需在服务器上安装 Microsoft Office。它将复杂的格式处理抽象为简洁的面向对象 API。它提供统一的 API 用于内容马赛克、转换和格式发现，支持 PDF、Office 文档、图像等，同时确保高性能和安全性。

为什么要使用 GroupDocs.Redaction 列出文件扩展名？

该库 支持 50 多种输入和输出格式，包括 PDF、DOCX、PPTX、XLSX、HTML，以及超过 30 种图像类型。通过编程方式 列出文件扩展名，您可以：

  • 防止用户上传不受支持的文件（将验证错误降低至最高 90%）。
  • 动态填充下拉菜单，确保 UI 与库更新保持同步。
  • 构建审计日志，记录用户尝试处理的确切文件类型。

前提条件

  • GroupDocs.Redaction：通过 NuGet 安装（请参见下面的命令）。
  • .NET SDK：确保已安装最新的 .NET SDK。请在 here 下载。
  • IDE：Visual Studio 2022 或任何兼容的编辑器。
  • Basic C# knowledge：您应该熟悉集合和 LINQ。

为 .NET 设置 GroupDocs.Redaction

安装库

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • 打开 NuGet 包管理器，搜索 “GroupDocs.Redaction”，并安装最新版本。

获取并应用许可证

从免费试用开始或请求临时许可证，以在无限制的情况下探索全部功能。购买选项请访问 GroupDocs’ purchase page。获取许可证文件后：

  1. 将其放置在项目内部的可访问文件夹中（例如 ./Licenses/GroupDocs.Redaction.lic）。
  2. 在应用程序启动时初始化许可证：

License 类加载您的许可证文件并激活 GroupDocs.Redaction。

   using GroupDocs.Redaction.License;
   
   License lic = new License();
   lic.SetLicense("path/to/your/license/file");

如何使用 GroupDocs.Redaction 列出文件扩展名？

加载 Redaction API 并调用返回受支持格式的方法。该调用返回一个集合，每个项目包含扩展名和可读的描述。此操作轻量，可在启动时或按需执行。

检索受支持的文件类型

RedactionApi.GetSupportedFileFormats() 方法返回一个只读的 FileFormatInfo 对象集合，描述每种格式。

using GroupDocs.Search.Results;
using System;
using System.Collections.Generic;

// Using LINQ to order the supported file formats by their extensions.
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes()
    .OrderBy(ft => ft.Extension);

显示每个扩展名及其描述

每个 FileFormatInfo 为文件类型提供 Extension 和 Description 属性。

foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType.Extension.PadRight(8) + " - " + fileType.Description);
}

说明：循环遍历每个 FileFormatInfo 对象，在整齐对齐的表格中打印其 Extension 和 Description。

如何将列表集成到 UI 下拉框中？

获取集合后，将其绑定到任何 UI 组件——WinForms ComboBox、WPF ComboBox 或 ASP.NET Core select 元素。关键是使用 Extension 作为值，Description 作为显示文本。这可确保用户看到友好的名称，而代码使用确切的扩展名字符串。

常见问题及解决方案

  • 缺少命名空间错误 – 请确认已导入 GroupDocs.Redaction 和 GroupDocs.Redaction.Common。
  • 未找到许可证 – 确保许可证文件路径正确，并且文件已包含在生成输出中。
  • 大型项目的性能 – 将结果缓存到静态变量或分布式缓存（例如 Redis）中，以避免重复枚举。

实际应用

了解受支持扩展名的完整列表可开启多个实际场景：

  1. 文档管理系统 – 根据扩展名自动对传入文件进行分类。
  2. 内容过滤工具 – 在上传时阻止不允许的格式（例如可执行文件）。
  3. 文件转换流水线 – 动态决定文件是否可以转换或需要回退工作流。

性能考虑因素

  • 内存占用 – 格式列表存储在轻量级的 IReadOnlyCollection 中，通常小于 2 KB。
  • 线程安全 – 该集合在创建后不可变，因而对并发读取安全。
  • 缓存 – 对于高流量 API，建议在应用程序生命周期内缓存列表，以消除每次请求的几微秒开销。

结论

按照上述步骤操作后，您现在拥有使用 GroupDocs.Redaction 列出文件扩展名 并 c# 显示文件格式 的可靠方法。此功能不仅提升用户体验，还保护后端免受不受支持的文件影响。探索更多 Redaction 功能——如内容遮蔽、PDF 马赛克和批处理——以进一步强化文档工作流。

常见问题解答

Q: 默认支持的文件格式有哪些？
A: GroupDocs.Redaction 支持 50 多种格式，包括 PDF、DOCX、PPTX、XLSX、HTML、BMP、JPEG、PNG 等。完整列表请参见 GroupDocs documentation。

Q: 如何将库升级到最新版本？
A: 打开 NuGet 包管理器，搜索 “GroupDocs.Redaction”，然后点击 Update。或者运行 dotnet add package GroupDocs.Redaction --version <latest>。

Q: 我可以使用此列表对上传的文件进行服务器端验证吗？
A: 可以——在处理之前，将上传文件的扩展名与检索到的集合进行比较。这可消除 99% 的无效格式错误。

Q: 能否扩展支持自定义文件类型？
A: 自定义扩展名需要自定义处理程序；核心库本身不原生添加新格式。请查阅 API 文档了解如何创建自定义导入/导出管道。

Q: 添加代码后我的应用崩溃——我应该检查什么？
A: 确保许可证已正确加载，using 语句引用了正确的命名空间，并在读取许可证文件时处理 IOException。

最后更新： 2026-06-07
测试环境： GroupDocs.Redaction 23.9 for .NET
作者： GroupDocs

资源

相关教程