Introdução

Neste tutorial, aprenderemos como assinar um documento PDF e adicionar metadados usando o GroupDocs.Signature para .NET. Adicionar metadados aprimora o documento, fornecendo informações essenciais como autoria, data de criação, ID do documento e muito mais.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

  1. GroupDocs.Signature para .NET: Baixe em aqui.
  2. Um documento PDF: tenha um arquivo PDF de exemplo pronto para assinar.
  3. Conhecimento básico de programação em C#: é necessária familiaridade com a sintaxe do C# para entender os exemplos de código.

Importar namespaces

Comece importando os namespaces necessários para acessar as classes e métodos necessários:

using System;
using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

Etapa 1: Carregue o documento PDF

Especifique o caminho do documento PDF que você deseja assinar:

string filePath = "sample.pdf";

Etapa 2: especifique o caminho do arquivo de saída

Defina onde o PDF assinado com metadados será salvo:

string outputFilePath = Path.Combine("Your Document Directory", "SignPdfWithMetadata", "SignedWithMetadata.pdf");

Etapa 3: Criar uma instância de assinatura

Inicializar um Signature instância com o caminho para o documento PDF:

using (Signature signature = new Signature(filePath))
{
    // código relacionado à assinatura será colocado aqui
}

Etapa 4: Definir opções de metadados

Criar MetadataSignOptions e adicione os campos de metadados junto com seus valores:

MetadataSignOptions options = new MetadataSignOptions();
options
    .Add(new PdfMetadataSignature("Author", "Mr. Sherlock Holmes")) // Valor da sequência de caracteres
    .Add(new PdfMetadataSignature("CreatedOn", DateTime.Now))       // Valor de data e hora
    .Add(new PdfMetadataSignature("DocumentId", 123456))            // Valor inteiro
    .Add(new PdfMetadataSignature("SignatureId", 123.456D))         // Valor duplo
    .Add(new PdfMetadataSignature("Amount", 123.456M))              // Valor decimal
    .Add(new PdfMetadataSignature("Total", 123.456F));              // Valor flutuante

Etapa 5: Assine o documento

Assine o documento PDF com as opções de metadados especificadas e salve o documento assinado:

SignResult result = signature.Sign(outputFilePath, options);
Console.WriteLine($"\nSource document signed successfully with {result.Succeeded.Count} signature(s).\nFile saved at {outputFilePath}.");

Conclusão

Neste tutorial, abordamos como assinar um documento PDF com metadados usando o GroupDocs.Signature para .NET. Seguindo esses passos, você pode facilmente enriquecer seus arquivos PDF com metadados valiosos, melhorando sua rastreabilidade e utilidade.

Perguntas frequentes

Posso adicionar campos de metadados personalizados aos meus documentos PDF?

Sim, você pode adicionar campos de metadados personalizados especificando o nome do campo e seu valor correspondente usando GroupDocs.Signature para .NET.

O GroupDocs.Signature for .NET é compatível com todas as versões do .NET Framework?

GroupDocs.Signature para .NET é compatível com várias versões do .NET Framework, garantindo flexibilidade e facilidade de integração.

O GroupDocs.Signature oferece suporte à assinatura de outros formatos de documento além de PDF?

Sim, o GroupDocs.Signature suporta uma ampla variedade de formatos de documentos, incluindo Word, Excel, PowerPoint e muito mais.

Posso assinar vários documentos em massa usando o GroupDocs.Signature para .NET?

Com certeza! Você pode assinar vários documentos em massa iterando por uma lista de arquivos e aplicando o processo de assinatura programaticamente.

Há suporte técnico disponível para usuários do GroupDocs.Signature?

Sim, o GroupDocs oferece suporte técnico dedicado por meio de seus fóruns. Você pode acessar o fórum de suporte aqui.