Освоение GroupDocs.Signature для .NET: эффективное извлечение и отображение информации о документе

Введение

Хотите эффективно извлекать полную информацию из документов в своих приложениях? Надёжное решение необходимо для управления контрактами, соглашениями или многостраничными PDF-файлами. GroupDocs.Signature для .NET Предлагает мощные функции, разработанные для оптимизации анализа документов путем извлечения и отображения таких элементов, как поля форм, подписи, метаданные и т. д. Это руководство поможет вам использовать эти возможности для улучшения функциональности вашего приложения.

Что вы узнаете:

  • Как получить подробную информацию о документе с помощью GroupDocs.Signature для .NET
  • Отображение различных типов подписей и сведений о полях формы
  • Извлечение метаданных и атрибутов, специфичных для страницы

Прежде чем приступить к реализации, рассмотрим предварительные условия.

Предпосылки

Прежде чем использовать GroupDocs.Signature для .NET, убедитесь, что ваша среда правильно настроена. Данное руководство предполагает знакомство с C# и базовые знания принципов обработки документов.

Необходимые библиотеки и зависимости

  • GroupDocs.Signature для .NET: Основная библиотека, которую мы будем использовать.
  • .NET Framework или .NET Core: В зависимости от настроек вашего проекта.

Настройка среды

Убедитесь, что у вас готова среда разработки с Visual Studio или другой подходящей IDE, поддерживающей проекты .NET.

Необходимые знания

  • Базовые знания программирования на языке C#.
  • Знакомство с типами документов (PDF, Word, Excel) и их свойствами.

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

Чтобы использовать GroupDocs.Signature для .NET, необходимо установить библиотеку. Вот несколько способов:

Инструкция по установке

Использование .NET CLI:

dotnet add package GroupDocs.Signature

Использование консоли менеджера пакетов:

Install-Package GroupDocs.Signature

Пользовательский интерфейс менеджера пакетов NuGet: Найдите «GroupDocs.Signature» в диспетчере пакетов NuGet и установите последнюю версию.

Приобретение лицензии

Чтобы в полной мере использовать GroupDocs.Signature, рассмотрите возможность приобретения лицензии:

  • Бесплатная пробная версия: Начните с бесплатной пробной версии, чтобы изучить функции.
  • Временная лицензия: Получите временную лицензию для расширенного тестирования.
  • Покупка: Купить полную лицензию для использования в производстве.

После установки и лицензирования инициализируйте свой проект, настроив среду GroupDocs.Signature, как показано ниже:

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // Определите путь к файлу документа, который вы хотите проанализировать.
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // Замените на фактический путь к документу.
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // Дальнейшие операции будут проводиться здесь...
        }
    }
}

Руководство по внедрению

Завершив настройку, давайте рассмотрим, как реализовать различные функции GroupDocs.Signature для .NET.

Извлечение и отображение основных свойств документа

Обзор: извлечение основных свойств, таких как формат файла, размер и количество страниц.

Пошаговая реализация:

  1. Инициализировать объект подписи: Создайте экземпляр Signature класс с путем к вашему документу.
  2. Метод GetDocumentInfo: Используйте GetDocumentInfo() метод получения подробной информации о документе.
  3. Показать свойства документа: Вывод основных свойств, таких как формат, расширение и размер, с помощью Console.WriteLine для отладки или ведения журнала.
IDocumentInfo documentInfo = signature.GetDocumentInfo();
Console.WriteLine($"Document properties {Path.GetFileName(filePath)}:");
Console.WriteLine($" - format : {documentInfo.FileType.FileFormat}");
Console.WriteLine($" - extension : {documentInfo.FileType.Extension}");
Console.WriteLine($" - size : {documentInfo.Size}");
Console.WriteLine($" - page count : {documentInfo.PageCount}");

Отображение информации о каждой странице документа

Обзор: Получите более подробное представление, извлекая и отображая информацию о каждой странице документа.

Пошаговая реализация:

  1. Перебирать страницы: Цикл по documentInfo.Pages для доступа к отдельным параметрам страницы, таким как ширина и высота.
foreach (PageInfo pageInfo in documentInfo.Pages)
{
    Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
}

Отображение информации о подписях полей формы

Обзор: Извлечение и отображение информации, связанной с полями формы в документе.

Пошаговая реализация:

  1. Доступ к полям формы: Использовать documentInfo.FormFields для извлечения всех подписей полей формы, присутствующих в документе.
  2. Отображение сведений о каждом поле формы: Перебрать каждое поле формы и вывести его тип, имя и значение.
Console.WriteLine($"Document Form Fields information: count = {documentInfo.FormFields.Count}");
foreach (FormFieldSignature formField in documentInfo.FormFields)
{
    Console.WriteLine($" - type #{formField.Type}: Name: {formField.Name} Value: {formField.Value}");
}

Отображение различной информации о подписях

Обзор: извлечение и отображение информации для текстовых, графических, цифровых подписей, штрих-кодов, QR-кодов, полей форм и метаданных.

Этапы реализации:

  • Текстовые подписи: Доступ documentInfo.TextSignatures для получения подробной информации о каждой текстовой подписи, включая ее идентификатор, местоположение, размер и дату создания.
Console.WriteLine($"Document Text signatures: {documentInfo.TextSignatures.Count}");
foreach (TextSignature textSignature in documentInfo.TextSignatures)
{
    Console.WriteLine($" - #{textSignature.SignatureId}: Text: {textSignature.Text} Location: {textSignature.Left}x{textSignature.Top}. Size: {textSignature.Width}x{textSignature.Height}. CreatedOn/ModifiedOn: {textSignature.CreatedOn.ToShortDateString()} / {textSignature.ModifiedOn.ToShortDateString()}");
}
  • Подписи изображений: Подобно текстовым подписям, используйте documentInfo.ImageSignatures для получения подробной информации, например о размере и формате подписей изображений.
Console.WriteLine($"Document Image signatures: {documentInfo.ImageSignatures.Count}");
foreach (ImageSignature imageSignature in documentInfo.ImageSignatures)
{
    Console.WriteLine($" - #{imageSignature.SignatureId}: Size: {imageSignature.Size} bytes, Format: {imageSignature.Format}. CreatedOn/ModifiedOn: {imageSignature.CreatedOn.ToShortDateString()} / {imageSignature.ModifiedOn.ToShortDateString()}");
}
  • Цифровые подписи: Для цифровых подписей используйте documentInfo.DigitalSignatures для извлечения идентификаторов подписей и временных меток.
Console.WriteLine($"Document Digital signatures: {documentInfo.DigitalSignatures.Count}");
foreach (DigitalSignature digitalSignature in documentInfo.DigitalSignatures)
{
    Console.WriteLine($" - #{digitalSignature.SignatureId}. CreatedOn/ModifiedOn: {digitalSignature.CreatedOn.ToShortDateString()} / {digitalSignature.ModifiedOn.ToShortDateString()}");
}
  • Подписи штрих-кодов и QR-кодов: Использовать documentInfo.BarcodeSignatures и documentInfo.QrCodeSignatures для сбора данных штрих-кода и QR-кода соответственно.
Console.WriteLine($"Document Barcode signatures: {documentInfo.BarcodeSignatures.Count}");
foreach (BarcodeSignature barcodeSignature in documentInfo.BarcodeSignatures)
{
    Console.WriteLine($" - #{barcodeSignature.SignatureId}: Type: {barcodeSignature.EncodeType?.TypeName}. Text: {barcodeSignature.Text}");
}

Console.WriteLine($"Document QR Code signatures: {documentInfo.QrCodeSignatures.Count}");
foreach (QrCodeSignature qrCodeSignature in documentInfo.QrCodeSignatures)
{
    Console.WriteLine($" - #{qrCodeSignature.SignatureId}: Type: {qrCodeSignature.EncodeType?.TypeName}. Text: {qrCodeSignature.Text}");
}

Заключение

Следуя этому руководству, вы научились использовать GroupDocs.Signature для .NET для эффективного извлечения и отображения полной информации о документах. Этот набор навыков повысит точность и простоту управления документами в вашем приложении.

Дальнейшие шаги:

  • Изучите дополнительные возможности GroupDocs.Signature.
  • Реализуйте проверку подписи в своих приложениях.
  • Интегрируйте эту функцию в более крупные рабочие процессы для автоматизированной обработки документов.