Отображение поддерживаемых форматов файлов с помощью GroupDocs.Redaction в .NET

Управление широким спектром типов документов — ежедневная реальность для .NET‑разработчиков. С помощью GroupDocs.Redaction вы можете список расширений файлов, которые поддерживает библиотека, предоставляя вашему приложению возможность принимать или отклонять загрузки, предлагать удобные варианты в UI и избегать дорогостоящих ошибок выполнения. Этот учебник проведёт вас через всё необходимое — от предварительных требований до полной, готовой к продакшн реализации — чтобы вы уверенно получить форматы файлов и c# отображать форматы файлов в своём решении.

Быстрые ответы

  • Что означает “list file extensions”? Это означает получение коллекции поддерживаемых идентификаторов типов файлов (например, .pdf, .docx) из API.
  • Какой пакет 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. Скачайте его здесь.
  • IDE: Visual Studio 2022 или любой совместимый редактор.
  • Базовые знания C#: Вы должны быть уверены в работе с коллекциями и LINQ.

Настройка GroupDocs.Redaction для .NET

Установить библиотеку

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • Откройте NuGet Package Manager, найдите “GroupDocs.Redaction” и установите последнюю версию.

Получить и применить лицензию

Начните с бесплатной пробной версии или запросите временную лицензию, чтобы изучить все возможности без ограничений. Для вариантов покупки посетите страницу покупки GroupDocs. После получения файла лицензии:

  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 или элемент select в ASP.NET Core. Ключевой момент — использовать Extension в качестве значения и Description в качестве отображаемого текста. Это гарантирует, что пользователи видят понятные названия, а ваш код работает с точными строками расширений.

Распространённые проблемы и решения

  • Ошибка отсутствующего пространства имён – Убедитесь, что импортированы GroupDocs.Redaction и GroupDocs.Redaction.Common.
  • Лицензия не найдена – Убедитесь, что путь к файлу лицензии правильный и файл включён в вывод сборки.
  • Производительность в больших проектах – Кэшируйте результат в статической переменной или распределённом кэше (например, Redis), чтобы избежать повторной переборки.

Практические применения

Знание точного списка поддерживаемых расширений открывает несколько реальных сценариев:

  1. Системы управления документами – Автоматически классифицировать входящие файлы по их расширению.
  2. Инструменты фильтрации контента – Блокировать запрещённые форматы (например, исполняемые файлы) при загрузке.
  3. Конвейеры конвертации файлов – Динамически определять, может ли файл быть конвертирован или нужен альтернативный процесс.

Соображения по производительности

  • Потребление памяти – Список форматов хранится в лёгкой IReadOnlyCollection, обычно менее 2 KB.
  • Потокобезопасность – Коллекция неизменяема после создания, что делает её безопасной для одновременного чтения.
  • Кэширование – Для API с высокой нагрузкой кэшируйте список на время жизни приложения, чтобы избавиться от нескольких микросекунд накладных расходов на каждый запрос.

Заключение

Следуя приведённым выше шагам, вы теперь имеете надёжный способ список расширений файлов и c# отображать форматы файлов с использованием GroupDocs.Redaction. Эта возможность не только улучшает пользовательский опыт, но и защищает ваш бэкенд от неподдерживаемых файлов. Исследуйте дополнительные функции Redaction — такие как маскирование содержимого, редактирование PDF и пакетная обработка — чтобы ещё сильнее укрепить ваш документооборот.

Часто задаваемые вопросы

Q: Каковы стандартные поддерживаемые форматы файлов?
A: GroupDocs.Redaction поддерживает более 50 форматов, включая PDF, DOCX, PPTX, XLSX, HTML, BMP, JPEG, PNG и многие другие. Полный список доступен в документации GroupDocs.

Q: Как обновить библиотеку до последней версии?
A: Откройте NuGet Package Manager, найдите “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

Ресурсы

Связанные руководства