Cómo aplicar marcas de agua personalizadas en PDF en C#

Cómo añadir marcas de agua a PDFs en C#; usando IronPDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF permite añadir marcas de agua personalizadas a los PDF con una sola línea de código utilizando cadenas HTML para un control total del estilo. Aplica marcas de agua de texto o imagen con opacidad, rotación y posicionamiento ajustables para mejorar la seguridad y la imagen de marca de los documentos.

como-encabezado:2(Inicio rápido: Aplicar marcas de agua personalizadas sin esfuerzo)

Añada marcas de agua personalizadas a los PDF mediante IronPDF con una sola línea de código. Personaliza las marcas de agua con estilos HTML de opacidad, rotación y ubicación mediante un sencillo sistema de cuadrícula de 3x3. Esta guía muestra cómo mejorar documentos PDF con marcas de agua personalizadas por motivos de seguridad y de marca.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronPDF con el gestor de paquetes NuGet

    PM > Install-Package IronPdf

  2. Copie y ejecute este fragmento de código.

    new IronPdf.PdfDocument.FromFile("input.pdf")
        .ApplyWatermark("<h1 style='opacity:0.5;'>Confidential</h1>", IronPdf.PagePosition.TopCenter)
        .SaveAs("output.pdf");
  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronPDF en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

¿Cuáles son los pasos básicos para añadir una marca de agua?

  1. Descarga la biblioteca IronPDF para C#
  2. Renderizar un documento PDF nuevo o importar uno existente
  3. Configura la cadena HTML a ser utilizada como marca de agua
  4. Utilice el método ApplyWatermark para implementar una marca de agua
  5. Personalice la rotación, la opacidad y la ubicación de la marca de agua según sea necesario

¿Cómo aplico una marca de agua a mi PDF?

Utilice el método ApplyWatermark para aplicar una marca de agua a un PDF recién renderizado o existente. Este método acepta una cadena HTML como marca de agua, habilitando todas las funciones HTML, incluido el estilo CSS. El siguiente ejemplo muestra el uso de imágenes y texto como marcas de agua. Tenga en cuenta que las marcas de agua se aplican a todas las páginas; no se admiten marcas de agua específicas de la página.

Antes de trabajar con marcas de agua, revise nuestras guías sobre creación de PDF o conversión de HTML a PDF para comprender los conceptos básicos de la generación de PDF con IronPDF.

¿Qué elementos HTML puedo utilizar en mi marca de agua?

:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark-apply-watermark.cs
using IronPdf;

string watermarkHtml = @"
<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>");

// Apply watermark
pdf.ApplyWatermark(watermarkHtml);

pdf.SaveAs("watermark.pdf");
$vbLabelText   $csharpLabel

La cadena HTML de la marca de agua admite todos los elementos HTML y estilos CSS estándar. Incluye imágenes, texto, fuentes personalizadas, colores y diseños complejos. Esta flexibilidad permite crear marcas de agua profesionales que se ajusten a los requisitos de la marca. Para opciones de estilo avanzadas, utilice fuentes web e iconos en las marcas de agua.

¿Qué aspecto tiene el PDF final con marca de agua?

Añade fácilmente marcas de agua de imágenes de varios formatos (PNG, JPG) y marcas de agua de texto con fuentes personalizadas. Las marcas de agua aparecen detrás del contenido principal, lo que garantiza la legibilidad del documento al tiempo que proporciona características de marca o seguridad.


¿Cómo puedo ajustar la opacidad y la rotación de la marca de agua?

Las marcas de agua se aplican con una opacidad predeterminada del 50%, que puede ajustarse según las necesidades. El método ApplyWatermark incluye una sobrecarga que acepta la rotación como parámetro. Especifique "rotación:" y "opacidad:" para ajustar estos parámetros.

Para situaciones complejas de marcas de agua, explore nuestras funciones de estampado para obtener opciones de personalización adicionales.

¿Qué parámetros controlan la apariencia de la marca de agua?

:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark-apply-rotation-opacity.cs
using IronPdf;
using IronPdf.Editing;

string watermarkHtml = @"
<img style='width: 200px;' src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>");

// Apply watermark with 45 degrees rotation and 70% opacity
pdf.ApplyWatermark(watermarkHtml, rotation: 45, opacity: 70);

pdf.SaveAs("watermarkOpacity&Rotation.pdf");
$vbLabelText   $csharpLabel

El parámetro de rotación acepta valores en grados (0-360), lo que permite marcas de agua diagonales comúnmente utilizadas para borradores o documentos confidenciales. El parámetro de opacidad acepta valores de 0 a 100, donde 0 es totalmente transparente y 100 totalmente opaco. Estos parámetros proporcionan un control preciso del impacto visual de la marca de agua.

Trabajar con diferentes niveles de opacidad

Los distintos tipos de documentos requieren diferentes niveles de opacidad:

  • Documentos jurídicos: Utiliza un 20-30% de opacidad para marcas de agua sutiles
  • Documentos en borrador: Utiliza una opacidad del 40-60% para una visibilidad clara
  • Documentos confidenciales: Utilizar un 30-50% de opacidad con rotación diagonal
  • Documentos de marca: Utiliza un 10-25% de opacidad para una apariencia profesional
// Example: Creating a subtle branded watermark
string brandWatermark = @"
<div style='font-family: Arial, sans-serif; color: #cccccc;'>
    <img style='width: 150px;' src='company-logo.png'>
    <p>© 2024 Company Name</p>
</div>";

pdf.ApplyWatermark(brandWatermark, rotation: 0, opacity: 20);
// Example: Creating a subtle branded watermark
string brandWatermark = @"
<div style='font-family: Arial, sans-serif; color: #cccccc;'>
    <img style='width: 150px;' src='company-logo.png'>
    <p>© 2024 Company Name</p>
</div>";

pdf.ApplyWatermark(brandWatermark, rotation: 0, opacity: 20);
$vbLabelText   $csharpLabel

¿Cómo afectan la rotación y la opacidad al resultado final?


¿Cómo coloco mi marca de agua en el PDF?

Especifique la ubicación de la marca de agua utilizando una cuadrícula de 3x3 dividida en 3 columnas horizontales y 3 filas verticales. Las opciones horizontales son izquierda, centro y derecha; las opciones verticales son superior, intermedia e inferior. Esta configuración permite 9 ubicaciones diferentes en cada página. Véase la siguiente imagen para una representación visual.

Cuadrícula de alineación de marca de agua de IronPDF que muestra 9 opciones de posicionamiento con propiedades de alineación vertical y horizontal

Añada marcas de agua a ubicaciones específicas mediante los enums VerticalAlignment y HorizontalAlignment del espacio de nombres IronPDF.Editing. Este sistema de posicionamiento se integra con otras funciones de manipulación de páginas de IronPDF.

¿Qué Enums de alineación debo usar para el posicionamiento?

:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark-apply-rotation-opacity.cs
using IronPdf;
using IronPdf.Editing;

string watermarkHtml = @"
<img style='width: 200px;' src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>");

// Apply watermark with 45 degrees rotation and 70% opacity
pdf.ApplyWatermark(watermarkHtml, rotation: 45, opacity: 70);

pdf.SaveAs("watermarkOpacity&Rotation.pdf");
$vbLabelText   $csharpLabel

Técnicas avanzadas de posicionamiento

Para requisitos de posicionamiento complejos, combine marcas de agua con margenes personalizados y transformaciones específicas de página. He aquí un ejemplo de creación de varias marcas de agua en distintas posiciones:

// Example: Adding multiple watermarks with different positions
string dateWatermark = $"<p style='font-size: 10px;'>Generated: {DateTime.Now:yyyy-MM-dd}</p>";
string confidentialWatermark = "<h2 style='color: red;'>CONFIDENTIAL</h2>";
string pageNumberWatermark = "<p style='font-size: 12px;'>Page {page} of {total}</p>";

// Apply date at top-left
pdf.ApplyWatermark(dateWatermark, 30, VerticalAlignment.Top, HorizontalAlignment.Left);

// Apply confidential mark at center
pdf.ApplyWatermark(confidentialWatermark, 50, VerticalAlignment.Middle, HorizontalAlignment.Center);

// Note: For page numbers, consider using Headers and Footers instead
// Example: Adding multiple watermarks with different positions
string dateWatermark = $"<p style='font-size: 10px;'>Generated: {DateTime.Now:yyyy-MM-dd}</p>";
string confidentialWatermark = "<h2 style='color: red;'>CONFIDENTIAL</h2>";
string pageNumberWatermark = "<p style='font-size: 12px;'>Page {page} of {total}</p>";

// Apply date at top-left
pdf.ApplyWatermark(dateWatermark, 30, VerticalAlignment.Top, HorizontalAlignment.Left);

// Apply confidential mark at center
pdf.ApplyWatermark(confidentialWatermark, 50, VerticalAlignment.Middle, HorizontalAlignment.Center);

// Note: For page numbers, consider using Headers and Footers instead
$vbLabelText   $csharpLabel

¿Cuáles son los patrones de posicionamiento habituales para las marcas de agua?

Mejores prácticas para marcas de agua profesionales

Cuando cree marcas de agua para documentos profesionales, siga estas prácticas recomendadas:

  1. Mantener la legibilidad: garantizar que las marcas de agua no interfieran con el contenido del documento
  2. Consistencia de marca: Utilizar colores y fuentes de la empresa que coincidan con las directrices de la marca
  3. Consideraciones de seguridad: Para documentos confidenciales, combine marcas de agua con Encriptación de PDF
  4. Rendimiento: Para el procesamiento por lotes, optimice el HTML de marca de agua y utilice operaciones asíncronas

Marcas de agua en aplicaciones empresariales

Para las aplicaciones empresariales que procesan grandes volúmenes de PDF, implemente marcas de agua junto con Compresión de PDF para optimizar el tamaño de los archivos. Integre la marca de agua en su proceso de generación de PDF para el procesamiento automatizado de documentos.

¿Listo para ver qué más puedes hacer? Consulte nuestra página de tutoriales aquí: Editar PDFs

Preguntas Frecuentes

¿Cómo agrego una marca de agua a un PDF en C#?

Puede añadir marcas de agua a los PDF utilizando el método ApplyWatermark de IronPDF con una sola línea de código. Simplemente cargue su documento PDF y llame a ApplyWatermark con una cadena HTML que contenga el contenido y la posición de su marca de agua: new IronPdf.PdfDocument.FromFile("input.pdf").ApplyWatermark("Confidential", IronPdf.PagePosition.TopCenter).SaveAs("output.pdf");

¿Qué tipos de marcas de agua puedo añadir a mi PDF?

IronPDF admite marcas de agua tanto de texto como de imagen. Puede utilizar cualquier contenido HTML como marca de agua, incluido texto con fuentes personalizadas, imágenes en varios formatos (PNG, JPG) e incluso diseños complejos con estilo CSS completo. La marca de agua aparece detrás del contenido principal para garantizar la legibilidad del documento.

¿Puedo personalizar la posición de mi marca de agua?

Sí, IronPDF utiliza un sencillo sistema de cuadrícula de 3x3 para colocar las marcas de agua. Puede colocar marcas de agua en posiciones como TopCenter, BottomRight o cualquiera de las nueve posiciones estándar de la página. La posición se especifica como parámetro en el método ApplyWatermark.

¿Cómo puedo ajustar la opacidad y la rotación de la marca de agua?

IronPDF aplica marcas de agua con una opacidad predeterminada del 50%, pero puede personalizarla utilizando el parámetro de opacidad. El método ApplyWatermark incluye una sobrecarga que acepta los parámetros de rotación y opacidad, lo que permite crear marcas de agua semitransparentes o rotadas para mejorar los efectos visuales.

¿Puedo aplicar diferentes marcas de agua a páginas específicas?

Actualmente, IronPDF aplica marcas de agua a todas las páginas de un documento PDF. No se admiten marcas de agua específicas para cada página. Cuando utilice el método ApplyWatermark, la marca de agua aparecerá en todas las páginas del PDF.

¿Qué características HTML y CSS son compatibles con las marcas de agua?

La función de marca de agua de IronPDF admite todos los elementos HTML y estilos CSS estándar. Esto incluye fuentes personalizadas, colores, fuentes web, iconos y diseños complejos. Puede crear marcas de agua profesionales que se adapten a sus requisitos de marca utilizando toda la potencia de HTML y CSS.

Curtis Chau
Escritor Técnico

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 ...

Leer más
¿Listo para empezar?
Nuget Descargas 17,012,929 | Versión: 2025.12 recién lanzado