Introducción

En este tutorial, aprenderemos a firmar un documento PDF y a añadir metadatos con GroupDocs.Signature para .NET. Añadir metadatos mejora el documento al proporcionar información esencial como la autoría, la fecha de creación, el ID del documento y más.

Prerrequisitos

Antes de comenzar, asegúrese de tener lo siguiente:

  1. GroupDocs.Signature para .NET: Descárguelo desde aquí.
  2. Un documento PDF: Tenga un archivo PDF de muestra listo para firmar.
  3. Conocimientos básicos de programación en C#: es necesario estar familiarizado con la sintaxis de C# para comprender los ejemplos de código.

Importar espacios de nombres

Comience importando los espacios de nombres necesarios para acceder a las clases y métodos necesarios:

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

Paso 1: Cargue el documento PDF

Especifique la ruta del documento PDF que desea firmar:

string filePath = "sample.pdf";

Paso 2: Especifique la ruta del archivo de salida

Define dónde se guardará el PDF firmado con metadatos:

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

Paso 3: Crear una instancia de firma

Inicializar un Signature instancia con la ruta al documento PDF:

using (Signature signature = new Signature(filePath))
{
    // El código relacionado con la firma irá aquí
}

Paso 4: Definir las opciones de metadatos

Crear MetadataSignOptions y agregue los campos de metadatos junto con sus valores:

MetadataSignOptions options = new MetadataSignOptions();
options
    .Add(new PdfMetadataSignature("Author", "Mr. Sherlock Holmes")) // Valor de cadena
    .Add(new PdfMetadataSignature("CreatedOn", DateTime.Now))       // Valor de fecha y hora
    .Add(new PdfMetadataSignature("DocumentId", 123456))            // Valor entero
    .Add(new PdfMetadataSignature("SignatureId", 123.456D))         // Doble valor
    .Add(new PdfMetadataSignature("Amount", 123.456M))              // Valor decimal
    .Add(new PdfMetadataSignature("Total", 123.456F));              // Valor flotante

Paso 5: Firmar el documento

Firme el documento PDF con las opciones de metadatos especificadas y guarde el documento firmado:

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

Conclusión

En este tutorial, explicamos cómo firmar un documento PDF con metadatos usando GroupDocs.Signature para .NET. Siguiendo estos pasos, podrá enriquecer fácilmente sus archivos PDF con metadatos valiosos, mejorando así su trazabilidad y utilidad.

Preguntas frecuentes

¿Puedo agregar campos de metadatos personalizados a mis documentos PDF?

Sí, puede agregar campos de metadatos personalizados especificando el nombre del campo y su valor correspondiente utilizando GroupDocs.Signature para .NET.

¿GroupDocs.Signature para .NET es compatible con todas las versiones de .NET Framework?

GroupDocs.Signature para .NET es compatible con varias versiones de .NET Framework, lo que garantiza flexibilidad y facilidad de integración.

¿GroupDocs.Signature admite la firma de otros formatos de documentos además de PDF?

Sí, GroupDocs.Signature admite una amplia gama de formatos de documentos, incluidos Word, Excel, PowerPoint y más.

¿Puedo firmar varios documentos en masa usando GroupDocs.Signature para .NET?

¡Por supuesto! Puedes firmar varios documentos a la vez iterando una lista de archivos y aplicando el proceso de firma programáticamente.

¿Hay soporte técnico disponible para los usuarios de GroupDocs.Signature?

Sí, GroupDocs ofrece soporte técnico especializado a través de sus foros. Puede acceder al foro de soporte. aquí.