Подписание и проверка основных документов с помощью GroupDocs.Signature для .NET

Как освоить подписывание и проверку документов с помощью GroupDocs.Signature для .NET

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

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

Как подписывать документы с помощью настраиваемых текстовых подписей
Методы эффективной проверки подписанных документов
Методы поиска существующих текстовых подписей в документах
Действия по обновлению и удалению текстовых подписей по мере необходимости
Лучшие практики по оптимизации производительности и управления памятью

Давайте начнем с обзора предварительных условий.

Предпосылки

Прежде чем начать, убедитесь, что ваша среда разработки оснащена необходимыми инструментами:

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

GroupDocs.Signature для .NET: Эта библиотека позволяет вам добавлять функции подписи в ваши приложения.
.NET Framework 4.6.1 или выше (или .NET Core 2.x+)

Требования к настройке среды

Для загрузки необходимых пакетов вам понадобится среда разработки C#, например Visual Studio, и подключение к Интернету.

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

Рекомендуется знакомство с базовыми концепциями программирования на C#. Если вы новичок в GroupDocs.Signature для .NET, не волнуйтесь — это руководство поможет вам пройти все этапы.

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

Для начала вам необходимо установить библиотеку GroupDocs.Signature в свой проект. Вот как это сделать:

Установка через .NET CLI

dotnet add package GroupDocs.Signature

Консоль менеджера пакетов

Install-Package GroupDocs.Signature

Пользовательский интерфейс менеджера пакетов NuGet

Откройте свой проект в Visual Studio.
Перейти к Инструменты > Менеджер пакетов NuGet > Управление пакетами NuGet для решения.
Найдите «GroupDocs.Signature» и установите последнюю версию.

Этапы получения лицензии

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

Базовая инициализация и настройка

После установки инициализируйте GroupDocs.Signature в вашем проекте следующим образом:

using GroupDocs.Signature;

// Инициализируйте экземпляр Signature, указав путь к документу.
Signature signature = new Signature("path/to/your/document.pdf");

Теперь, когда все настроено, давайте рассмотрим, как использовать GroupDocs.Signature для различных функций.

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

Подписать документ текстовой подписью

Эта функция позволяет добавлять текстовые подписи в документ. Давайте разберёмся:

Обзор

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

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

Шаг 1: Определите путь к файлу и местонахождение выходных данных.

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // Путь к исходному документу
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");

Шаг 2: Создайте текстовую подпись, используя TextSignOptions.

using (Signature signature = new Signature(filePath))
{
    TextSignOptions signOptions = new TextSignOptions("John Smith")
    {
        VerticalAlignment = GroupDocs.Signature.Options.VerticalAlignment.Top,
        HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Center,
        Width = 100,
        Height = 40,
        Margin = new Padding(20),
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };

Шаг 3: Подписание документа и вывод результатов.

    SignResult signResult = signature.Sign(outputFilePath, signOptions);
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signed Text Signature: Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}

Основные параметры конфигурации

Вертикальное выравнивание и горизонтальное выравниваниеУправление местом появления подписи на странице.
Шрифт: Настройте размер и стиль шрифта для текстовой подписи.

Проверить документ на наличие текстовой подписи

Проверка гарантирует, что документ подписан надлежащим образом. Вот как это реализовать:

Обзор

Проверьте имеющиеся текстовые подписи в ваших документах, чтобы подтвердить их подлинность и целостность.

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

Шаг 1: Укажите путь к файлу подписанного документа.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Путь к подписанному документу

Шаг 2: Создайте варианты проверки с помощью TextVerifyOptions.

using (Signature signature = new Signature(filePath))
{
    TextVerifyOptions verifyOptions = new TextVerifyOptions()
    {
        AllPages = false,
        PageNumber = 1,
        Text = "John Smith",
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact
    };

Шаг 3: Проверьте документ.

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Document was verified successfully!");
    }
    else
    {
        Console.WriteLine("Document failed verification process.");
    }
}

Советы по устранению неполадок

Обеспечить Text свойство точно соответствует тому, что находится в документе.
Проверьте, что PageNumber соответствует правильной странице, содержащей подпись.

Поиск документа по текстовой подписи

Эффективно находите текстовые подписи в документах с помощью этой функции.

Обзор

Выполните поиск по всем или выбранным страницам документа, чтобы найти определенные текстовые подписи.

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

Шаг 1: Определите путь к файлу.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Путь к подписанному документу

Шаг 2: Использовать TextSearchOptions для поиска.

using (Signature signature = new Signature(filePath))
{
    TextSearchOptions searchOptions = new TextSearchOptions()
    {
        AllPages = true,
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact,
        Text = "John Smith"
    };

Шаг 3: Выполнить поиск.

    List<TextSignature> signatures = signature.Search<TextSignature>(searchOptions);
    foreach (TextSignature textSignature in signatures)
    {
        if (textSignature != null)
        {
            Console.WriteLine($"Found Text signature at page {textSignature.PageNumber} with type [{textSignature.SignatureImplementation}] and text '{textSignature.Text}'. Location: {textSignature.Left}-{textSignature.Top}. Size is {textSignature.Width}x{textSignature.Height}.");
        }
    }
}

Обновить подпись текста документа

При необходимости измените существующие текстовые подписи в документе.

Обзор

Настройте свойства существующих текстовых подписей, такие как размер и местоположение.

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

Шаг 1: Укажите путь к файлу и идентификаторы подписи.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Путь к подписанному документу
List<string> signatureIds = new List<string>(); // Предположим, что этот список заполнен действительными идентификаторами подписей.

Шаг 2: Создавать TextSignature объекты для обновлений.

using (Signature signature = new Signature(filePath))
{
    foreach (var item in signatureIds)
    {
        TextSignature temp = new TextSignature(item)
        {
            Width = 150,
            Height = 50,
            HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Right
        };

Шаг 3: Обновите документ.

        SignResult signResult = signature.UpdateSignatures(temp);
        if (signResult.Succeeded.Count > 0)
        {
            Console.WriteLine($"Updated Text Signature: Id:{temp.SignatureId}");
        }
    }
}

Основные параметры конфигурации

Ширина и высота: Отрегулируйте размер подписи.
Горизонтальное выравнивание: Управление местом появления обновленной подписи на странице.

Заключение

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