Comment ajouter des filigranes aux PDFs en C# en using IronPDF
IronPDF ajoute des filigranes de texte ou d'image à n'importe quel PDF avec la méthode ApplyWatermark, qui prend une chaîne HTML vous permettant de contrôler le style, l'opacité, la rotation et le placement via le CSS et une grille d'alignement 3x3. Le filigrane se trouve derrière le contenu de la page, gardant le document lisible tout en portant une marque ou un marquage de sécurité.
Démarrage rapide : Appliquer un filigrane en une seule ligne
Rendez ou ouvrez un PDF, puis appelez ApplyWatermark avec une chaîne HTML. La surcharge à quatre arguments prend le HTML, une valeur d'opacité, et une paire VerticalAlignment / HorizontalAlignment qui place le marque sur la page.
-
Installez IronPDF avec le Gestionnaire de Packages NuGet
-
Copiez et exécutez cet extrait de code.
IronPdf.PdfDocument.FromFile("input.pdf") .ApplyWatermark("<h1 style='color:red;'>Confidential</h1>", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center) .SaveAs("output.pdf"); -
Déployez pour tester sur votre environnement de production.
Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit
Flux de travail minimal (5 étapes)
- Télécharger la bibliothèque IronPDF depuis NuGet
- Rendez un nouveau PDF ou ouvrez un existant
- Écrivez le filigrane sous forme de chaîne HTML
- Appelez la méthode
ApplyWatermark - Ajustez la rotation, l'opacité et l'alignement selon les besoins
Comment appliquer un filigrane à mon PDF?
Appelez ApplyWatermark sur un PdfDocument fraîchement rendu ou importé. La méthode accepte une chaîne HTML, afin que le filigrane puisse comporter des images, du texte, des polices personnalisées, des couleurs et une mise en page CSS. L'exemple ci-dessous combine une image de logo et un en-tête en une seule marque. Les filigranes s'appliquent à chaque page du document; les marques par page ne sont pas prises en charge via cette méthode.
Si vous devez d'abord créer le document source, consultez les guides sur la création de PDF et la conversion de HTML en PDF.
Quel HTML puis-je mettre dans un filigrane ?
: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")
La chaîne du filigrane accepte tout HTML et CSS standard, y compris les images distantes et les polices et icônes web. Parce que la marque se rend derrière le contenu de la page, le texte original reste lisible tandis que le filigrane fournit une marque ou une étiquette de statut.
À quoi ressemble le PDF avec filigrane ?
Comment puis-je régler l'opacité et la rotation du filigrane ?
Un filigrane s'applique à 50 % d'opacité par défaut. Pour le modifier, passez opacity: (0 à 100, où 0 est transparent et 100 est totalement opaque) et rotation: (0 à 360 degrés) comme arguments nommés. Une rotation de 45 degrés produit la marque diagonale commune sur les documents d'ébauche et confidentiels.
Quels paramètres contrôlent l'opacité et la rotation ?
: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")
L'argument rotation tourne le marque autour de son centre, et opacity détermine à quel point il transparaît. Ensemble, ils ajustent à quel point le filigrane est proéminent par rapport à la page en-dessous.
Que produisent la rotation et l'opacité ?
Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.
Comment positionner mon filigrane sur le PDF?
IronPDF place des filigranes sur une grille 3x3 : trois colonnes horizontales (gauche, centre, droite) et trois rangées verticales (haut, milieu, bas), donnant neuf positions par page. Sélectionnez un emplacement avec les enums VerticalAlignment et HorizontalAlignment du namespace IronPdf.Editing. L'image ci-dessous mappe chaque paire d'énumérations à sa position.
Ce sont les mêmes énumérations utilisées par la fonctionnalité texte et image estampés, de sorte que le positionnement se comporte de manière cohérente dans les deux.
Quelle énumération d'alignement positionne le filigrane ?
: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")
Cet appel passe une valeur d'opacité suivie de VerticalAlignment.Top et HorizontalAlignment.Right, ancrant le marque dans le coin supérieur droit. Échangez les valeurs d'énumération pour déplacer le filigrane vers l'une des neuf positions de la grille.
À quoi ressemble le filigrane positionné ?
Conclusion
Vous avez appliqué des filigranes de texte et d'image avec ApplyWatermark, ajusté leur opacité et rotation, et les avez ancrés avec la grille VerticalAlignment / HorizontalAlignment. Quand une seule marque ne suffit pas, les mêmes énumérations d'alignement dirigent la fonctionnalité texte et image estampés pour les superpositions par région et les couches pleine page.
Questions Fréquemment Posées
Comment ajouter un filigrane à un PDF en C# ?
Vous pouvez ajouter un filigrane à un PDF en utilisant la méthode ApplyWatermark d'IronPDF avec une seule ligne de code. Chargez votre document PDF et appelez ApplyWatermark avec une chaîne HTML, une valeur d'opacité et une paire VerticalAlignment / HorizontalAlignment : IronPdf.PdfDocument.FromFile("input.pdf").ApplyWatermark("
Confidentiel
", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center).SaveAs("output.pdf");Quels types de filigranes puis-je ajouter à mon PDF ?
IronPDF prend en charge les filigranes de texte et d'image. Vous pouvez utiliser n'importe quel contenu HTML comme filigrane, y compris du texte avec des polices personnalisées, des images dans différents formats (PNG, JPG), et même des mises en page complexes avec un style CSS complet. Le filigrane apparaît derrière le contenu principal pour garantir la lisibilité du document.
Puis-je personnaliser la position de mon filigrane ?
Oui, IronPDF utilise une simple grille 3x3 pour le positionnement des filigranes. Sélectionnez une position avec les énumérations VerticalAlignment (Top, Middle, Bottom) et HorizontalAlignment (Left, Center, Right) du namespace IronPdf.Editing, offrant neuf positions standard sur la page. La paire d'alignements est passée en arguments à la méthode ApplyWatermark.
Comment puis-je régler l'opacité et la rotation du filigrane ?
IronPDF applique des filigranes avec une opacité par défaut de 50 %, mais vous pouvez la personnaliser à l'aide du paramètre opacity. La méthode ApplyWatermark comprend une surcharge qui accepte les paramètres de rotation et d'opacité, ce qui vous permet de créer des filigranes semi-transparents ou pivotés pour des effets visuels améliorés.
Puis-je appliquer différents filigranes à des pages spécifiques ?
Actuellement, IronPDF applique des filigranes à toutes les pages d'un document PDF. Les filigranes spécifiques à une page ne sont pas pris en charge. Lorsque vous utilisez la méthode ApplyWatermark, le filigrane apparaîtra sur chaque page de votre PDF.
Quelles sont les fonctionnalités HTML et CSS prises en charge dans les filigranes ?
La fonctionnalité de filigrane d'IronPDF prend en charge tous les éléments HTML standard et le style CSS. Cela inclut les polices personnalisées, les couleurs, les polices web, les icônes et les dispositions complexes. Vous pouvez créer des filigranes correspondant à vos exigences de branding en utilisant les HTML et CSS standard.

