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# com IronPDF

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

O IronPDF permite adicionar marcas d'água personalizadas a PDFs com uma única linha de código, usando strings HTML para controle total do estilo. Aplique marcas d'água de texto ou imagem com opacidade, rotação e posicionamento ajustáveis ​​para aprimorar a segurança ao editar PDF e fortalecer a identidade visual dos documentos.

Início Rápido: Aplique Marcas D'água Personalizadas Sem Esforço

Adicione marcas d'água personalizadas a PDFs usando o IronPDF com uma única linha de código. Personalize marcas d'água com estilo HTML para opacidade, rotação e localização usando um sistema de grade simples de 3x3. Este guia mostra como aprimorar documentos PDF com marcas d'água personalizadas para fins de segurança e identidade visual.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf

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

    new IronPdf.PdfDocument.FromFile("input.pdf")
    .ApplyWatermark("<h1 style='opacity:0.5;'>Confidential</h1>", IronPdf.PagePosition.TopCenter)
    .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

Quais são os passos básicos para adicionar uma marca d'água?

  1. Baixe a biblioteca IronPDF para C#
  2. Criar um novo documento PDF ou importar um documento PDF existente.
  3. Configure a string HTML a ser usada como marca d'água.
  4. Utilize o método ApplyWatermark para implementar uma marca d'água.
  5. Personalize a rotação, a opacidade e a localização da marca d'água conforme necessário.

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

Use o método ApplyWatermark para aplicar uma marca d'água a um PDF recém-renderizado ou existente. Este método aceita uma string HTML como marca d'água, habilitando todos os recursos HTML, incluindo a estilização CSS. O exemplo abaixo demonstra o uso de imagem e texto como marcas d'água. Note que as marcas d'água se aplicam a todas as páginas; Não há suporte para marcas d'água específicas de página.

Antes de trabalhar com marcas d'água, revise nossos guias sobre como criar PDFs ou converter HTML em PDF para entender os conceitos básicos de geração de PDFs com o IronPDF.

Que elementos HTML posso usar na minha 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 HTML da marca d'água é compatível com todos os elementos HTML padrão e estilos CSS. Inclua imagens, texto, fontes personalizadas, cores e layouts complexos. Essa flexibilidade permite a criação de marcas d'água profissionais que atendem aos requisitos da marca. Para opções de estilo avançadas, use fontes e ícones da web em marcas d'água.

Qual é a aparência do PDF final com marca d'água?

Adicione marcas d'água de imagem em diversos formatos (PNG, JPG) e marcas d'água de texto com fontes personalizadas com facilidade. As marcas d'água aparecem atrás do conteúdo principal, garantindo a legibilidade do documento e, ao mesmo tempo, fornecendo recursos de marca ou segurança.

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

As marcas d'água são aplicadas com uma opacidade padrão de 50%, que pode ser ajustada conforme necessário. O método ApplyWatermark inclui uma sobrecarga que aceita a rotação como parâmetro. Especifique 'rotação:' e 'opacidade:' para ajustar esses parâmetros.

Para cenários complexos de marca d'água, explore nossos recursos de carimbo para opções de personalização adicionais.

Quais parâmetros controlam a aparência da marca d'água?

: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 parâmetro de rotação aceita valores em graus (0-360), permitindo marcas d'água diagonais comumente usadas para rascunhos ou documentos confidenciais. O parâmetro de opacidade aceita valores de 0 a 100, onde 0 é completamente transparente e 100 é totalmente opaco. Esses parâmetros proporcionam um controle preciso sobre o impacto visual da marca d'água.

Trabalhando com diferentes níveis de opacidade

Diferentes tipos de documentos exigem diferentes níveis de opacidade:

  • Documentos legais : Use opacidade de 20 a 30% para marcas d'água sutis.
  • Documentos de rascunho : Use opacidade de 40 a 60% para melhor visualização.
  • Documentos confidenciais : Use opacidade de 30 a 50% com rotação diagonal.
  • Documentos personalizados : Use opacidade de 10 a 25% para uma aparência profissional.
// 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);
Imports System

' Example: Creating a subtle branded watermark
Dim brandWatermark As String = "
<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

Como a rotação e a opacidade afetam o resultado final?

Como posiciono minha marca d'água no PDF?

Especifique a localização da marca d'água usando uma grade 3x3 dividida em 3 colunas na horizontal e 3 linhas na vertical. As opções horizontais são esquerda, centro e direita; As opções verticais são: superior, central e inferior. Essa configuração permite 9 locais diferentes em cada página. Veja a imagem abaixo para uma representação visual.

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

Adicione marcas d'água a locais específicos usando as enumerações VerticalAlignment e HorizontalAlignment no namespace IronPdf.Editing. Este sistema de posicionamento integra-se com os outros recursos de manipulação de páginas do IronPDF.

Quais enumerações de alinhamento devo usar para posicionamento?

: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

Técnicas avançadas de posicionamento

Para requisitos de posicionamento complexos, combine marcas d'água com margens personalizadas e transformações específicas da página . Aqui está um exemplo de como criar várias marcas d'água em posições diferentes:

// 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
' Example: Adding multiple watermarks with different positions
Dim dateWatermark As String = $"<p style='font-size: 10px;'>Generated: {DateTime.Now:yyyy-MM-dd}</p>"
Dim confidentialWatermark As String = "<h2 style='color: red;'>CONFIDENTIAL</h2>"
Dim pageNumberWatermark As String = "<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

Quais são os padrões de posicionamento mais comuns para marcas d'água?

Melhores práticas para marcas d'água profissionais

Ao criar marcas d'água para documentos profissionais, siga estas boas práticas:

  1. Manter a legibilidade : Garantir que as marcas d'água não interfiram no conteúdo do documento.
  2. Identidade Visual Consistente : Utilize as cores e fontes da empresa de acordo com as diretrizes da marca.
  3. Considerações de segurança : Para documentos confidenciais, combine marcas d'água com criptografia de PDF.
  4. Desempenho : Para processamento em lote, otimize o HTML da marca d'água e utilize operações assíncronas.

Marca d'água em aplicações empresariais

Para aplicações empresariais que processam grandes volumes de PDFs, implemente marcas d'água juntamente com a compressão de PDF para otimizar o tamanho dos arquivos. Integre a marca d'água ao seu fluxo de trabalho de geração de PDFs para o processamento automatizado de documentos.

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Editar PDFs

Perguntas frequentes

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

Você pode adicionar marcas d'água a PDFs usando o método ApplyWatermark do IronPDF com apenas uma linha de código. Basta carregar seu documento PDF e chamar ApplyWatermark com uma string HTML contendo o conteúdo e a posição da sua marca d'água: new IronPdf.PdfDocument.FromFile("input.pdf").ApplyWatermark("Confidential", IronPdf.PagePosition.TopCenter).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 um sistema de grade simples de 3x3 para o posicionamento de marcas d'água. Você pode colocar marcas d'água em posições como Centro Superior, Direita Inferior ou em qualquer uma das nove posições padrão na página. A posição é especificada como um parâmetro no 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 é compatível com 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 profissionais que correspondam aos requisitos da sua marca, utilizando todo o poder do HTML e do CSS.

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 18,318,263 | Versão: 2026.4 acaba de ser 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.