"Can I extract metadata from password‑protected PDFs?"

"Yes. Provide the password when constructing `RedactionEngine`; the API will decrypt the header and return metadata."

"Does the API support batch processing of multiple files?"

"Absolutely. Loop through your file collection, instantiate `RedactionEngine` for each, and call `GetDocumentInfo()`—the engine is lightweight enough for thousands of files."

"What happens if a document has no metadata?"

"The corresponding properties return `null` or default values; you can safely check for `null` before using them."

"Is it possible to modify metadata after extraction?"

"GroupDocs.Redaction focuses on redaction, not editing metadata. Use GroupDocs.Metadata or another library for write‑back scenarios."

"Which .NET versions are officially supported?"

".NET Framework 4.7.2+, .NET Core 3.1+, .NET 5+, and .NET 6+ are fully supported."

Учебные материалы по информации о документах для GroupDocs.Redaction .NET

В этом центре вы узнаете, как извлекать метаданные документа из широкого спектра типов файлов, определять количество страниц и создавать изображения предварительного просмотра перед выполнением операций редактирования. Программно получая эту информацию, вы можете решить, какие файлы требуют особой обработки, обеспечить соблюдение правил соответствия и улучшить общую производительность обработки. Все примеры написаны на C# и ориентированы на .NET 6+, так что их можно сразу добавить в существующие проекты.

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

Как извлечь метаданные? Используйте RedactionEngine.GetDocumentInfo() для получения свойств, таких как автор, дата создания и количество страниц.
Можно ли читать метаданные из потока? Да — передайте MemoryStream, содержащий файл, в тот же метод API.
Какие форматы поддерживаются? Более 100 форматов, включая PDF, DOCX, PPTX и файлы изображений.
Быстро ли получение количества страниц? Движок читает только заголовок файла, предоставляя количество страниц менее чем за 50 мс для большинства документов.
Нужна ли лицензия для разработки? Временная лицензия подходит для тестирования; полная лицензия требуется для продакшн.

Что такое «извлечение метаданных документа»?

Извлечение метаданных документа означает программное получение встроенных свойств — таких как автор, заголовок, дата создания и количество страниц — из файла без его открытия в просмотрщике. Эта легковесная операция позволяет вашему приложению принимать обоснованные решения до начала редактирования.

Почему извлекать метаданные документа с помощью GroupDocs.Redaction?

GroupDocs.Redaction может читать метаданные более чем 100 форматов файлов, при этом потребление памяти не превышает 10 МБ для документов до 500 страниц. API возвращает полностью типизированный объект DocumentInfo, устраняя необходимость в пользовательских парсерах и сокращая время разработки до 70 %.

Требования

.NET 6+ (или .NET Core 3.1 / .NET Framework 4.7.2)
Установлен пакет NuGet GroupDocs.Redaction for .NET
Временный или полный лицензионный ключ (доступен в портале GroupDocs)

Как извлечь метаданные документа с помощью GroupDocs.Redaction .NET?

RedactionEngine — основной компонент, который загружает документы и предоставляет методы извлечения метаданных. GetDocumentInfo() возвращает объект DocumentInfo, содержащий метаданные, такие как автор, заголовок и количество страниц. Загрузите файл (или поток) с помощью RedactionEngine, вызовите GetDocumentInfo() и прочитайте возвращённые свойства. Операция завершается одной строкой кода и не требует загрузки всего документа в память.

Как получить количество страниц из документа?

DocumentInfo — типизированный объект, который хранит извлечённые метаданные документа. Свойство DocumentInfo.PageCount возвращает общее количество страниц. Это значение вычисляется из заголовка файла, позволяя движку определить количество страниц без полной загрузки документа, поэтому даже PDF‑документ из 300 страниц обрабатывается за несколько миллисекунд.

Как прочитать метаданные из потока?

RedactionEngine загружает документ из пути к файлу или из потока и предоставляет возможности извлечения метаданных. Передайте экземпляр Stream (например, MemoryStream) в RedactionEngine вместо пути к файлу. Движок читает заголовок потока, извлекает метаданные и затем автоматически освобождает поток, обеспечивая минимальное потребление памяти и быструю обработку даже больших файлов.

Как извлечь метаданные на C#?

Используйте следующий шаблон:

Создайте экземпляр RedactionEngine, указав путь к файлу или поток.
Вызовите GetDocumentInfo().
Обратитесь к свойствам, таким как Author, Title, CreatedDate и PageCount.

Эти шаги дают вам полную снимок метаданных, готовый к использованию в бизнес‑логике.

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

Метаданные пусты – Убедитесь, что исходный файл действительно содержит встроенные свойства; некоторые сканы удаляют метаданные.
Ошибка неподдерживаемого формата – Проверьте, что расширение файла указано в таблице поддерживаемых форматов GroupDocs.Redaction (более 100 записей).
Снижение производительности на больших файлах – Используйте флаг LoadOptions ReadOnly = true, чтобы избежать ненужного выделения ресурсов.

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

Q: Могу ли я извлечь метаданные из PDF, защищённых паролем?
A: Да. Укажите пароль при создании RedactionEngine; API расшифрует заголовок и вернёт метаданные.

Q: Поддерживает ли API пакетную обработку нескольких файлов?
A: Абсолютно. Пройдитесь по коллекции файлов, создайте RedactionEngine для каждого и вызовите GetDocumentInfo() — движок достаточно лёгок, чтобы обрабатывать тысячи файлов.

Q: Что происходит, если у документа нет метаданных?
A: Соответствующие свойства возвращают null или значения по умолчанию; вы можете безопасно проверять их на null перед использованием.

Q: Можно ли изменить метаданные после их извлечения?
A: GroupDocs.Redaction ориентирован на редактирование, а не на изменение метаданных. Для сценариев записи используйте GroupDocs.Metadata или другую библиотеку.

Q: Какие версии .NET официально поддерживаются?
A: .NET Framework 4.7.2+, .NET Core 3.1+, .NET 5+ и .NET 6+ полностью поддерживаются.

Заключение

Освоив техники извлечения метаданных документа, вы даёте своим приложениям возможность принимать более умные решения по редактированию, обеспечивать соблюдение политик соответствия и повышать общую скорость обработки. Изучите ссылки на учебные материалы ниже, чтобы увидеть конкретные реализации для предварительного просмотра одностраничных документов, извлечения из потоков и полного получения метаданных.

Дополнительные ресурсы

Последнее обновление: 2026-06-06
Тестировано с: GroupDocs.Redaction 4.0 for .NET
Автор: GroupDocs