Cómo configurar y editar metadatos PDF

por Jordi

Los metadatos de un documento PDF se refieren a información descriptiva sobre el propio documento. Los metadatos de un PDF incluyen información como el título del documento, autor, asunto, palabras clave, fecha de creación, fecha de modificación, etc. Los metadatos permiten indexar y buscar mejor los PDF en las bases de datos. También aumenta su capacidad de búsqueda en Internet.




Biblioteca NuGet C# para PDF

Instalar con NuGet

Install-Package IronPdf
o
Java PDF JAR

Descargar DLL

Descargar DLL

Instalar manualmente en su proyecto

Ejemplo de configuración y edición de metadatos

Con IronPDF, configurar y editar los campos de metadatos genéricos de los PDF es un proceso sencillo. Puede acceder fácilmente a la propiedad MetaData para modificar los campos de metadatos disponibles.

:path=/static-assets/pdf/content-code-examples/how-to/metadata-set-edit.cs
using IronPdf;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>");

//  Acceda a la clase MetaData y establezca las propiedades de metadatos predefinidas.
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

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>")

'  Acceda a la clase MetaData y establezca las propiedades de metadatos predefinidas.
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")
VB   C#

Salida PDF

Para ver los metadatos del documento, haga clic en los tres puntos verticales y acceda a las Propiedades del documento.

Establecer y recuperar el diccionario de metadatos

El método GetMetaDataDictionary permite recuperar el diccionario de metadatos existente y acceder a la información de metadatos almacenada en el documento. El método SetMetaDataDictionary proporciona una forma eficaz de reescribir el diccionario de metadatos. Si una clave no está presente en los campos de metadatos genéricos, se considerará una propiedad de metadatos del cliente.

:path=/static-assets/pdf/content-code-examples/how-to/metadata-set-and-get-metadata-dictionary.cs
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");

//  Establecer diccionario de metadatos
pdf.MetaData.SetMetaDataDictionary(newMetadata);

//  Recuperar diccionario de metadatos
Dictionary<string, string> metadataProperties = pdf.MetaData.GetMetaDataDictionary();
Imports IronPdf
Imports System.Collections.Generic

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>")

Private newMetadata As New Dictionary(Of String, String)()
newMetadata.Add("Title", "How to article")
newMetadata.Add("Author", "IronPDF")

'  Establecer diccionario de metadatos
pdf.MetaData.SetMetaDataDictionary(newMetadata)

'  Recuperar diccionario de metadatos
Dim metadataProperties As Dictionary(Of String, String) = pdf.MetaData.GetMetaDataDictionary()
VB   C#

Salida PDF

Para ver los metadatos del documento, haga clic en los tres puntos verticales y acceda a las Propiedades del documento.

Ejemplo de adición, edición y eliminación de metadatos personalizados

Además de los metadatos estándar de un documento PDF, tiene la posibilidad de incluir propiedades de metadatos personalizadas. Estas propiedades personalizadas no suelen ser visibles en el software de visualización de PDF, ya que normalmente sólo muestran los metadatos genéricos y puede que no recuperen todas las propiedades de metadatos existentes.

Añadir y editar metadatos personalizados

Para añadir metadatos personalizados basta con acceder a la propiedad CustomProperties e invocar el método Add. La edición de metadatos personalizados requiere pasar el valor de la clave a la propiedad CustomProperties y reasignar su valor.

:path=/static-assets/pdf/content-code-examples/how-to/metadata-custom-properties.cs
using IronPdf;
using IronPdf.MetaData;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>");

PdfCustomMetadataProperties customProperties = pdf.MetaData.CustomProperties;

//  Añadir propiedad personalizada
customProperties.Add("foo", "bar"); //  Clave: foo, Valor: bar

//  Editar propiedad personalizada
customProperties["foo"] = "baz";
Imports IronPdf
Imports IronPdf.MetaData

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>")

Private customProperties As PdfCustomMetadataProperties = pdf.MetaData.CustomProperties

'  Añadir propiedad personalizada
customProperties.Add("foo", "bar") '  Clave: foo, Valor: bar

'  Editar propiedad personalizada
customProperties("foo") = "baz"
VB   C#

Eliminar metadatos personalizados

Hay dos formas de eliminar metadatos personalizados de un documento PDF. Puede utilizar el método RemoveMetaDataKey, accesible a través de la propiedad Metadata, o utilizar el método Remove de la propiedad CustomProperties.

:path=/static-assets/pdf/content-code-examples/how-to/metadata-remove-custom-properties.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>");

//  Añadir propiedad personalizada a eliminar
pdf.MetaData.CustomProperties.Add("willBeDeleted", "value");

//  Eliminar propiedad personalizada _ dos maneras
pdf.MetaData.RemoveMetaDataKey("willBeDeleted");
pdf.MetaData.CustomProperties.Remove("willBeDeleted");
Imports IronPdf

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Metadata</h1>")

'  Añadir propiedad personalizada a eliminar
pdf.MetaData.CustomProperties.Add("willBeDeleted", "value")

'  Eliminar propiedad personalizada _ dos maneras
pdf.MetaData.RemoveMetaDataKey("willBeDeleted")
pdf.MetaData.CustomProperties.Remove("willBeDeleted")
VB   C#