Cómo establecer y editar metadatos PDF en C# con IronPDF
IronPDF permite a los desarrolladores establecer y editar mediante programación metadatos PDF en aplicaciones C#, incluidas propiedades estándar como título, autor y palabras clave, así como campos de metadatos personalizados para mejorar la organización y la capacidad de búsqueda de documentos. Tanto si está creando aplicaciones empresariales que requieren el seguimiento de documentos, implementando funciones de cumplimiento u organizando su biblioteca de PDF, IronPDF proporciona funciones completas de manipulación de metadatos. This functionality integrates seamlessly with IronPDF's HTML to PDF conversion and other document processing features.
Inicio rápido: Modificar metadatos PDF al instanteGestione los metadatos PDF mediante IronPDF con sólo unas líneas de código. Cargue su PDF, actualice metadatos como el título, el autor o las palabras clave y guarde los cambios. Esta guía simplifica la configuración y edición de metadatos, asegurando que tus documentos estén bien organizados y sean buscables. Mejora las capacidades de tu PDF siguiendo este enfoque sencillo.
-
1Install IronPDF with NuGet Package Manager
-
2Copie y ejecute este fragmento de código.
IronPdf.PdfDocument.FromFile("example.pdf") .MetaData = new IronPdf.PdfMetaData { Title="MyDoc", Author="Me", Subject="Demo", Keywords="ironpdf,metadata", Creator="MyApp", Producer="IronPDF", CreationDate=DateTime.Today, ModifiedDate=DateTime.Now } .SaveAs("updated_example.pdf");C# -
3Despliegue para probar en su entorno real
Comienza a usar IronPDF en tu proyecto hoy mismo con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descargue la biblioteca IronPDF C# para la edición de metadatos PDF
- Carga un PDF existente o renderiza uno nuevo
- Accede a la propiedad
MetaDatapara establecer y editar los metadatos del PDF - Utilizar el diccionario de metadatos para el procesamiento eficaz de metadatos
- Añadir, editar o eliminar propiedades personalizadas de metadatos PDF
¿Cómo configurar y editar metadatos de PDF?
Cuando se utiliza IronPDF, la configuración y edición de campos de metadatos genéricos en PDF es sencilla. Accede a la propiedad MetaData para modificar los campos de metadatos disponibles. This functionality is particularly useful when working with PDF forms, digital signatures, or implementing document management systems.
using IronPdf;
using System;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>");
// Access the MetaData class and set the pre-defined metadata properties.
pdf.MetaData.Author = "Iron Software";
pdf.MetaData.CreationDate = DateTime.Today;
pdf.MetaData.Creator = "IronPDF";
pdf.MetaData.Keywords = "ironsoftware,ironpdf,pdf";
pdf.MetaData.ModifiedDate = DateTime.Now;
pdf.MetaData.Producer = "IronPDF";
pdf.MetaData.Subject = "Metadata Tutorial";
pdf.MetaData.Title = "IronPDF Metadata Tutorial";
pdf.SaveAs("pdf-with-metadata.pdf");Imports IronPdf
Imports System
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>")
' Access the MetaData class and set the pre-defined metadata properties.
pdf.MetaData.Author = "Iron Software"
pdf.MetaData.CreationDate = DateTime.Today
pdf.MetaData.Creator = "IronPDF"
pdf.MetaData.Keywords = "ironsoftware,ironpdf,pdf"
pdf.MetaData.ModifiedDate = DateTime.Now
pdf.MetaData.Producer = "IronPDF"
pdf.MetaData.Subject = "Metadata Tutorial"
pdf.MetaData.Title = "IronPDF Metadata Tutorial"
pdf.SaveAs("pdf-with-metadata.pdf")¿Cómo puedo ver los metadatos en el PDF de salida?
Para ver los metadatos del documento, haga clic en los tres puntos verticales y acceda a Propiedades del documento. This metadata is crucial for document organization, especially when implementing PDF/A compliant documents for long-term archival.
¿Cómo configuro y recupero el diccionario de metadatos?
El método GetMetaDataDictionary recupera el diccionario de metadatos existente y accede a la información de metadatos almacenada dentro del documento. El método SetMetaDataDictionary proporciona una manera efectiva de reescribir el diccionario de metadatos. Si una clave no está presente en los campos de metadatos genéricos, se convierte en una propiedad de metadatos personalizada. This approach is particularly useful when working with merging multiple PDFs and consolidating metadata from different sources.
using IronPdf;
using System.Collections.Generic;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>");
Dictionary<string, string> newMetadata = new Dictionary<string, string>();
newMetadata.Add("Title", "How to article");
newMetadata.Add("Author", "IronPDF");
// Set metadata dictionary
pdf.MetaData.SetMetaDataDictionary(newMetadata);
// Retreive metadata dictionary
Dictionary<string, string> metadataProperties = pdf.MetaData.GetMetaDataDictionary();Imports IronPdf
Imports System.Collections.Generic
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>")
Dim newMetadata As New Dictionary(Of String, String)()
newMetadata.Add("Title", "How to article")
newMetadata.Add("Author", "IronPDF")
' Set metadata dictionary
pdf.MetaData.SetMetaDataDictionary(newMetadata)
' Retrieve metadata dictionary
Dim metadataProperties As Dictionary(Of String, String) = pdf.MetaData.GetMetaDataDictionary()¿Qué ocurre cuando utilizo el diccionario de metadatos?
Para ver los metadatos del documento, haga clic en los tres puntos verticales y acceda a Propiedades del documento. El enfoque de diccionario de metadatos es especialmente útil cuando se implementan flujos de trabajo de procesamiento por lotes o se estandarizan metadatos en varios documentos. For advanced document management scenarios, consider combining this with PDF compression techniques to optimize file storage.
Trabajar con metadatos en diferentes contextos
En el desarrollo de aplicaciones empresariales, los metadatos desempeñan un papel crucial en la clasificación y recuperación de documentos. He aquí un ejemplo de implementación de un sistema integral de gestión de metadatos:
using IronPdf;
using System;
using System.Collections.Generic;
public class PDFMetadataManager
{
public static void ProcessBatchMetadata(List<string> pdfPaths)
{
foreach (string path in pdfPaths)
{
var pdf = PdfDocument.FromFile(path);
// Standardize metadata across all documents
pdf.MetaData.Producer = "Company Document System v2.0";
pdf.MetaData.Creator = "IronPDF";
// Add processing timestamp
pdf.MetaData.ModifiedDate = DateTime.Now;
// Add document classification
var metadata = pdf.MetaData.GetMetaDataDictionary();
metadata["DocumentType"] = "Internal Report";
metadata["Department"] = "Finance";
metadata["SecurityLevel"] = "Confidential";
pdf.MetaData.SetMetaDataDictionary(metadata);
pdf.SaveAs(path.Replace(".pdf", "_processed.pdf"));
}
}
}Imports IronPdf
Imports System
Imports System.Collections.Generic
Public Class PDFMetadataManager
Public Shared Sub ProcessBatchMetadata(pdfPaths As List(Of String))
For Each path As String In pdfPaths
Dim pdf = PdfDocument.FromFile(path)
' Standardize metadata across all documents
pdf.MetaData.Producer = "Company Document System v2.0"
pdf.MetaData.Creator = "IronPDF"
' Add processing timestamp
pdf.MetaData.ModifiedDate = DateTime.Now
' Add document classification
Dim metadata = pdf.MetaData.GetMetaDataDictionary()
metadata("DocumentType") = "Internal Report"
metadata("Department") = "Finance"
metadata("SecurityLevel") = "Confidential"
pdf.MetaData.SetMetaDataDictionary(metadata)
pdf.SaveAs(path.Replace(".pdf", "_processed.pdf"))
Next
End Sub
End Class¿Cómo puedo añadir, editar y eliminar metadatos personalizados?
Además de los metadatos estándar de un documento PDF, puede incluir propiedades de metadatos personalizadas. Estas propiedades personalizadas a menudo no son visibles en el software de visualización de PDF, ya que normalmente sólo muestran metadatos genéricos y pueden no recuperar todas las propiedades de metadatos existentes. Custom metadata is particularly valuable when implementing PDF security features or creating specialized document workflows.
¿Cómo añado y edito propiedades de metadatos personalizadas?
Para agregar metadatos personalizados, accede a la propiedad CustomProperties y llama al método Add. Editar metadatos personalizados requiere pasar el valor de la clave a la propiedad CustomProperties y reasignar su valor. This functionality integrates well with PDF form editing scenarios where you might need to track form submission metadata.
using IronPdf;
using IronPdf.MetaData;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>");
PdfCustomMetadataProperties customProperties = pdf.MetaData.CustomProperties;
// Add custom property
customProperties.Add("foo", "bar"); // Key: foo, Value: bar
// Edit custom property
customProperties["foo"] = "baz";Imports IronPdf
Imports IronPdf.MetaData
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>")
Dim customProperties As PdfCustomMetadataProperties = pdf.MetaData.CustomProperties
' Add custom property
customProperties.Add("foo", "bar") ' Key: foo, Value: bar
' Edit custom property
customProperties("foo") = "baz"Escenarios avanzados de metadatos personalizados
Los metadatos personalizados resultan especialmente útiles a la hora de crear sistemas de gestión de documentos. He aquí un ejemplo exhaustivo que demuestra el uso en el mundo real:
using IronPdf;
using System;
using System.Linq;
public class DocumentTrackingSystem
{
public static void AddTrackingMetadata(PdfDocument pdf, string userId, string projectId)
{
var customProps = pdf.MetaData.CustomProperties;
// Add tracking information
customProps.Add("ProcessedBy", userId);
customProps.Add("ProcessedDate", DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
customProps.Add("ProjectID", projectId);
customProps.Add("DocumentVersion", "1.0");
customProps.Add("ReviewStatus", "Pending");
// Add workflow metadata
customProps.Add("WorkflowStep", "Initial Review");
customProps.Add("NextReviewer", "John.Doe@company.com");
customProps.Add("DueDate", DateTime.Now.AddDays(7).ToString("yyyy-MM-dd"));
// Add compliance metadata
customProps.Add("ComplianceChecked", "false");
customProps.Add("RetentionPeriod", "7 years");
customProps.Add("Classification", "Internal Use Only");
}
public static void UpdateReviewStatus(PdfDocument pdf, string status, string reviewer)
{
var customProps = pdf.MetaData.CustomProperties;
// Update existing properties
customProps["ReviewStatus"] = status;
customProps["LastReviewedBy"] = reviewer;
customProps["LastReviewDate"] = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");
// Increment version if approved
if (status == "Approved" && customProps.ContainsKey("DocumentVersion"))
{
var currentVersion = customProps["DocumentVersion"];
var versionParts = currentVersion.Split('.');
var minorVersion = int.Parse(versionParts[1]) + 1;
customProps["DocumentVersion"] = $"{versionParts[0]}.{minorVersion}";
}
}
}Imports IronPdf
Imports System
Imports System.Linq
Public Class DocumentTrackingSystem
Public Shared Sub AddTrackingMetadata(pdf As PdfDocument, userId As String, projectId As String)
Dim customProps = pdf.MetaData.CustomProperties
' Add tracking information
customProps.Add("ProcessedBy", userId)
customProps.Add("ProcessedDate", DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"))
customProps.Add("ProjectID", projectId)
customProps.Add("DocumentVersion", "1.0")
customProps.Add("ReviewStatus", "Pending")
' Add workflow metadata
customProps.Add("WorkflowStep", "Initial Review")
customProps.Add("NextReviewer", "John.Doe@company.com")
customProps.Add("DueDate", DateTime.Now.AddDays(7).ToString("yyyy-MM-dd"))
' Add compliance metadata
customProps.Add("ComplianceChecked", "false")
customProps.Add("RetentionPeriod", "7 years")
customProps.Add("Classification", "Internal Use Only")
End Sub
Public Shared Sub UpdateReviewStatus(pdf As PdfDocument, status As String, reviewer As String)
Dim customProps = pdf.MetaData.CustomProperties
' Update existing properties
customProps("ReviewStatus") = status
customProps("LastReviewedBy") = reviewer
customProps("LastReviewDate") = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")
' Increment version if approved
If status = "Approved" AndAlso customProps.ContainsKey("DocumentVersion") Then
Dim currentVersion = customProps("DocumentVersion")
Dim versionParts = currentVersion.Split("."c)
Dim minorVersion = Integer.Parse(versionParts(1)) + 1
customProps("DocumentVersion") = $"{versionParts(0)}.{minorVersion}"
End If
End Sub
End Class¿Cómo elimino las propiedades de metadatos personalizados?
Elimine metadatos personalizados de un documento PDF de dos maneras. Utiliza el método RemoveMetaDataKey, accesible a través de la propiedad Metadata, o utiliza el método Remove desde la propiedad CustomProperties. This is particularly useful when sanitizing PDFs for public distribution or preparing documents for archival.
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>");
// Add custom property to be deleted
pdf.MetaData.CustomProperties.Add("willBeDeleted", "value");
// Remove custom property _ two ways
pdf.MetaData.RemoveMetaDataKey("willBeDeleted");
pdf.MetaData.CustomProperties.Remove("willBeDeleted");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>")
' Add custom property to be deleted
pdf.MetaData.CustomProperties.Add("willBeDeleted", "value")
' Remove custom property _ two ways
pdf.MetaData.RemoveMetaDataKey("willBeDeleted")
pdf.MetaData.CustomProperties.Remove("willBeDeleted")
Mi biblioteca favorita de este tipo es IronPDF. Permite una manipulación rápida y eficiente de archivos PDF. También tiene muchas funciones valiosas, como exportar al formato PDF/A y firmar documentos PDF digitalmente.
IronOCR significa que podemos ahorrar $40,000 anualmente en el procesamiento manual, mientras mejoramos la productividad y liberamos recursos para tareas de alto impacto. Lo recomendaría encarecidamente.
El Iron Suite juega un papel crucial en nuestras operaciones. Estas son herramientas que aumentan la eficiencia en toda la empresa, incluyendo la creación de planos y la mejora en la gestión de inventario.
Introducción
Los metadatos PDF son la columna vertebral de los sistemas de gestión de documentos, ya que permiten una organización eficaz, la posibilidad de realizar búsquedas y el seguimiento del cumplimiento de normativas. Las funciones de metadatos de IronPDF van más allá de la simple configuración de propiedades: proporcionan un marco completo para crear flujos de trabajo de documentos sofisticados. Whether implementing PDF/UA compliant documents for accessibility or creating custom tracking systems, metadata management is essential.
Bestes prácticas para la gestión de metadatos
- Consistencia: Establece convenciones de nomenclatura para las claves de metadatos personalizados
- Documentación: Mantén un registro de los campos de metadatos personalizados utilizados en tu sistema
- Validación: Implementa reglas de validación antes de establecer valores de metadatos
- Seguridad: Evita almacenar información sensible en los metadatos a menos que el PDF esté cifrado
- Cumplimiento: Asegúrese de que los metadatos cumplen los requisitos normativos de su sector
By leveraging IronPDF's metadata capabilities alongside features like digital signatures and PDF encryption, you can build robust document management solutions that meet enterprise requirements.
¿Listo para ver qué más puedes hacer? Consulta nuestra página de tutorial aquí: Firmar y Asegurar PDFs
Metadatos PDF en el contexto de la normativa española
Los metadatos tienen aplicaciones críticas para los sistemas de facturación y gestión documental en España, especialmente en lo relativo al cumplimiento de VeriFactu, Facturae, el SII de la AEAT y la LOPDGDD.
Metadatos XMP para auditoría fiscal (VeriFactu y SII)
El sistema SII (Suministro Inmediato de Información) de la AEAT requiere el envío de datos de facturas en plazos estrictos (generalmente 4 días naturales). Los metadatos personalizados pueden usarse para rastrear el estado de envío al SII dentro del ciclo de vida del PDF de la factura:
// Add SII submission tracking metadata to VeriFactu invoice
var facturaVeriFactu = PdfDocument.FromFile("factura_001.pdf");
var customProps = facturaVeriFactu.MetaData.CustomProperties;
// Fiscal compliance metadata
customProps.Add("VeriFactu_NumSerie", "FAC-2026-001234");
customProps.Add("VeriFactu_HashRegistro", "a3f8b2c1...");
customProps.Add("SII_FechaEnvio", DateTime.Now.ToString("yyyy-MM-ddTHH:mm:ss"));
customProps.Add("SII_EstadoEnvio", "CORRECTO");
customProps.Add("AEAT_NIF_Emisor", "B12345678");
customProps.Add("Facturae_Version", "3.2.2");
facturaVeriFactu.SaveAs("factura_001_con_metadatos_sii.pdf");Imports System
' Add SII submission tracking metadata to VeriFactu invoice
Dim facturaVeriFactu = PdfDocument.FromFile("factura_001.pdf")
Dim customProps = facturaVeriFactu.MetaData.CustomProperties
' Fiscal compliance metadata
customProps.Add("VeriFactu_NumSerie", "FAC-2026-001234")
customProps.Add("VeriFactu_HashRegistro", "a3f8b2c1...")
customProps.Add("SII_FechaEnvio", DateTime.Now.ToString("yyyy-MM-ddTHH:mm:ss"))
customProps.Add("SII_EstadoEnvio", "CORRECTO")
customProps.Add("AEAT_NIF_Emisor", "B12345678")
customProps.Add("Facturae_Version", "3.2.2")
facturaVeriFactu.SaveAs("factura_001_con_metadatos_sii.pdf")Campos de metadatos LOPDGDD para gestión del ciclo de vida
La AEPD recomienda documentar el ciclo de vida de los documentos que contienen datos personales. Los metadatos personalizados de IronPDF pueden registrar información de retención y tratamiento:
// LOPDGDD compliance metadata
customProps.Add("LOPDGDD_FechaExpiracion", DateTime.Now.AddYears(5).ToString("yyyy-MM-dd"));
customProps.Add("LOPDGDD_BaseJuridica", "Obligación legal fiscal");
customProps.Add("LOPDGDD_ResponsableTratamiento", "B12345678");
customProps.Add("LOPDGDD_FinalidadTratamiento", "Facturación y cumplimiento fiscal AEAT");' LOPDGDD compliance metadata
customProps.Add("LOPDGDD_FechaExpiracion", DateTime.Now.AddYears(5).ToString("yyyy-MM-dd"))
customProps.Add("LOPDGDD_BaseJuridica", "Obligación legal fiscal")
customProps.Add("LOPDGDD_ResponsableTratamiento", "B12345678")
customProps.Add("LOPDGDD_FinalidadTratamiento", "Facturación y cumplimiento fiscal AEAT")Nota: Los metadatos personalizados en PDFs no son visibles en la mayoría de los visores estándar. Para documentación de cumplimiento LOPDGDD, complemente estos metadatos con los registros del sistema de facturación y el Registro de Actividades de Tratamiento (RAT).
Metadatos estándar recomendados para facturas Facturae
Para PDFs de facturas compatibles con el formato Facturae (usado en B2G con la plataforma FACe), se recomiendan los siguientes campos de metadatos estándar:
| Campo MetaData | Valor recomendado para Facturae |
|---|---|
Title | Número de factura (ej: "FAC-2026-001234") |
Subject | "Factura electrónica Facturae 3.2.2" |
Keywords | "facturae, aeat, face, B2G" |
Creator | Nombre del software de facturación |
Producer | "IronPDF" |
Preguntas Frecuentes
¿Cómo establezco propiedades de metadatos PDF como título y autor en C#?
Con IronPDF, puede establecer fácilmente metadatos PDF accediendo a la propiedad MetaData de su documento PDF. Simplemente asigne un nuevo objeto PdfMetaData con propiedades como Título, Autor, Asunto, Palabras clave, Creador y fechas. IronPDF facilita la actualización de estos campos de metadatos estándar mediante programación.
¿Puedo añadir campos de metadatos personalizados a los PDF además de las propiedades estándar?
Sí, IronPDF admite campos de metadatos personalizados a través del diccionario de metadatos. Utilizando el método SetMetaDataDictionary, puede añadir cualquier par clave-valor más allá de los campos estándar. Si una clave no coincide con los campos de metadatos genéricos, IronPDF la trata automáticamente como metadatos personalizados.
¿Cómo puedo recuperar los metadatos existentes en un documento PDF?
IronPDF proporciona el método GetMetaDataDictionary para recuperar todos los metadatos existentes de un documento PDF. Este método devuelve un diccionario que contiene campos de metadatos estándar y personalizados, lo que permite acceder a la información de metadatos almacenada en el documento y procesarla.
¿Qué campos de metadatos estándar se pueden editar?
IronPDF admite todos los campos de metadatos PDF estándar, incluidos Título, Autor, Asunto, Palabras clave, Creador, Productor, Fecha de creación y Fecha de modificación. Estos campos pueden establecerse a través del objeto PdfMetaData y son esenciales para la organización y búsqueda de documentos.
¿Cómo puedo ver los metadatos después de configurarlos en el PDF?
Después de utilizar IronPDF para establecer los metadatos, puede visualizarlos en cualquier lector de PDF accediendo a las propiedades del documento. En la mayoría de los visores de PDF, haga clic en los tres puntos verticales o vaya al menú Archivo y seleccione Propiedades del documento para ver todos los campos de metadatos, incluidos los establecidos mediante programación.
¿Se puede combinar la manipulación de metadatos con otras operaciones de PDF?
Por supuesto IronPDF permite combinar la edición de metadatos con otras funciones como la conversión de HTML a PDF, la creación de formularios PDF y las firmas digitales. Esto lo hace ideal para crear sistemas completos de gestión de documentos o funciones de cumplimiento de normativas.
How does IronPDF handle batch processing of metadata?
IronPDF supports batch processing of metadata by allowing standardization of metadata across multiple documents, accessible via code loops that modify the `MetaData` properties.
What features does IronPDF offer to complement metadata management?
Apart from metadata management, IronPDF offers features like PDF compression, digital signatures, and encryption to ensure a comprehensive PDF management solution.
Why is metadata consistency important in document management?
Metadata consistency is crucial in document management as it ensures that all files are uniformly classified and tracked, facilitating easier retrieval and compliance with industry standards.
How does IronPDF integrate metadata with PDF/A compliance?
IronPDF integrates metadata with PDF/A by providing robust metadata management tools that align with the archival requirements stipulated under the PDF/A compliance standards.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
