1. IronPDF
  2. Tutoriais
  3. Marcas d'água personalizadas
Como aplicar marcas d'água personalizadas em PDFs usando C#

Como Adicionar Marcas d'água a PDFs em C# Usando IronPDF

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

O IronPDF adiciona marcas d'água de texto ou imagem a qualquer PDF com o método ApplyWatermark, que aceita uma string HTML para que você controle o estilo, opacidade, rotação e posição através de CSS e uma grade de alinhamento 3x3. A marca d'água fica atrás do conteúdo da página, mantendo o documento legível enquanto carrega uma marca de segurança ou de marca.

Início rápido: Aplicar uma Marca d'Água em Uma Linha

Renderize ou abra um PDF, em seguida chame ApplyWatermark com uma string HTML. A sobrecarga de quatro argumentos pega o HTML, um valor de opacidade, e um par VerticalAlignment / HorizontalAlignment que posiciona a marca na página.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf

  2. Copie e execute este trecho de código.

    IronPdf.PdfDocument.FromFile("input.pdf")
    .ApplyWatermark("<h1 style='color:red;'>Confidential</h1>", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center)
    .SaveAs("output.pdf");

  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita

    arrow pointer

Fluxo de trabalho mínimo (5 etapas)

  1. Baixe a biblioteca IronPDF do NuGet.
  2. Renderize um novo PDF ou abra um existente.
  3. Escreva a marca d'água como uma string HTML.
  4. Chame o método ApplyWatermark
  5. Ajuste a rotação, a opacidade e o alinhamento conforme necessário.


Como adiciono uma marca d'água ao meu PDF?

Chame ApplyWatermark em um PdfDocument recém-renderizado ou importado. O método aceita uma string HTML, de modo que a marca d'água pode conter imagens, texto, fontes personalizadas, cores e layout CSS. O exemplo abaixo combina uma imagem de logotipo e um título em uma única marca. Marcas d'água se aplicam a todas as páginas do documento; marcas por página não são suportadas por este método.

Se você precisar criar o documento fonte primeiro, veja os guias sobre criação de PDFs e conversão de HTML para PDF.

Que HTML Posso Colocar em uma Marca d'Água?

: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");
Imports IronPdf

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

Private renderer As New ChromePdfRenderer()

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

' Apply watermark
pdf.ApplyWatermark(watermarkHtml)

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

A string da marca d'água aceita qualquer HTML e CSS padrão, incluindo imagens remotas e fontes e ícones da web. Como a marca renderiza atrás do conteúdo da página, o texto original permanece legível enquanto a marca d'água fornece uma marca ou um rótulo de status.

Como a Marca d'Água no PDF Fica?

Como posso ajustar a opacidade e a rotação da marca d'água?

Uma marca d'água é aplicada com 50% de opacidade por padrão. Para alterá-lo, passe opacity: (0 a 100, onde 0 é transparente e 100 é totalmente opaco) e rotation: (0 a 360 graus) como argumentos nomeados. Uma rotação de 45 graus produz a marca diagonal comum em documentos de rascunho e confidenciais.

Quais Parâmetros Controlam a Opacidade e a Rotação?

: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");
Imports IronPdf
Imports IronPdf.Editing

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

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = 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

O argumento rotation gira a marca em torno do seu centro, e opacity define quão fortemente ela aparece. Juntos, eles ajustam quão proeminente a marca d'água é em relação à página abaixo dela.

O que a Rotação e a Opacidade Produzem?

Icon Quote related to O que a Rotação e a Opacidade Produzem?

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic related to O que a Rotação e a Opacidade Produzem?

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso
Icon Quote related to O que a Rotação e a Opacidade Produzem?

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle related to O que a Rotação e a Opacidade Produzem?

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso
Icon Quote related to O que a Rotação e a Opacidade Produzem?

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones related to O que a Rotação e a Opacidade Produzem?

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Como posiciono minha marca d'água no PDF?

IronPDF coloca marcas d'água em uma grade 3x3: três colunas horizontais (esquerda, centro, direita) e três linhas verticais (topo, meio, fundo), fornecendo nove posições por página. Selecione um ponto com os enums VerticalAlignment e HorizontalAlignment do namespace IronPdf.Editing. A imagem abaixo mapeia cada par de enums para sua posição.

Grade de alinhamento da marca d'água IronPDF mostrando 9 opções de posicionamento com propriedades de alinhamento vertical e horizontal.

Estes são os mesmos enums usados pelo recurso stamp text and image, portanto, o posicionamento se comporta de maneira consistente em ambos.

Quais Enums de Alinhamento Posicionam a Marca d'Água?

:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark-apply-watermark-top-right.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 on the top-right of the document
pdf.ApplyWatermark(watermarkHtml, 50, VerticalAlignment.Top, HorizontalAlignment.Right);

pdf.SaveAs("watermarkLocation.pdf");
Imports IronPdf
Imports IronPdf.Editing

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

Private renderer As New ChromePdfRenderer()

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

' Apply watermark on the top-right of the document
pdf.ApplyWatermark(watermarkHtml, 50, VerticalAlignment.Top, HorizontalAlignment.Right)

pdf.SaveAs("watermarkLocation.pdf")
$vbLabelText   $csharpLabel

Esta chamada passa um valor de opacidade seguido de VerticalAlignment.Top e HorizontalAlignment.Right, ancorando a marca no canto superior direito. Troque os valores dos enums para mover a marca d'água para qualquer uma das nove posições da grade.

Como a Marca d'Água Posicionada Fica?

Conclusão

Você aplicou marcas d'água de texto e imagem com ApplyWatermark, ajustou sua opacidade e rotação, e as ancorou com a grade VerticalAlignment / HorizontalAlignment. Quando uma única marca não é suficiente, os mesmos enums de alinhamento direcionam o recurso stamp text and image para sobreposições por região e camadas de página inteira.

Perguntas frequentes

Como adiciono uma marca d'água a um PDF em C#?

Você pode adicionar uma marca d'água a um PDF usando o método ApplyWatermark do IronPDF com apenas uma linha de código. Carregue seu documento PDF e chame ApplyWatermark com uma string HTML, um valor de opacidade e um par de VerticalAlignment/HorizontalAlignment: IronPdf.PdfDocument.FromFile("input.pdf").ApplyWatermark("

Confidencial

", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center).SaveAs("output.pdf");

Que tipos de marcas d'água posso adicionar ao meu PDF?

O IronPDF suporta marcas d'água de texto e de imagem. Você pode usar qualquer conteúdo HTML como marca d'água, incluindo texto com fontes personalizadas, imagens em vários formatos (PNG, JPG) e até mesmo layouts complexos com estilo CSS completo. A marca d'água aparece atrás do conteúdo principal para garantir a legibilidade do documento.

Posso personalizar a posição da minha marca d'água?

Sim, o IronPDF usa uma grade simples de 3x3 para posicionamento de marca d'água. Selecione um local com os enums VerticalAlignment (Top, Middle, Bottom) e HorizontalAlignment (Left, Center, Right) do namespace IronPdf.Editing, fornecendo nove posições padrão na página. O par de alinhamento é passado como argumentos para o método ApplyWatermark.

Como faço para ajustar a opacidade e a rotação da marca d'água?

O IronPDF aplica marcas d'água com uma opacidade padrão de 50%, mas você pode personalizar isso usando o parâmetro de opacidade. O método ApplyWatermark inclui uma sobrecarga que aceita parâmetros de rotação e opacidade, permitindo criar marcas d'água semitransparentes ou rotacionadas para efeitos visuais aprimorados.

Posso aplicar marcas d'água diferentes a páginas específicas?

Atualmente, o IronPDF aplica marcas d'água a todas as páginas de um documento PDF. Marcas d'água específicas para cada página não são suportadas. Ao usar o método ApplyWatermark, a marca d'água aparecerá em todas as páginas do seu PDF.

Quais recursos de HTML e CSS são suportados em marcas d'água?

O recurso de marca d'água do IronPDF suporta todos os elementos HTML padrão e estilos CSS. Isso inclui fontes personalizadas, cores, fontes da web, ícones e layouts complexos. Você pode criar marcas d'água que atendam aos requisitos de sua marca usando HTML e CSS padrão.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 19,936,792 | Versão: 2026.7 recém-lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.