1. IronPDF
  2. Guides pratiques
  3. Tamponner Texte et Images
Comment ajouter des tampons et des filigranes aux PDF en C#

Etiqueter du texte et des images sur des PDF en utilisant C# et IronPDF

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

IronPDF tamponne du texte, des images, du contenu HTML et des codes-barres sur des documents PDF existants en C# à l'aide des classes TextStamper, ImageStamper, HTMLStamper et BarcodeStamper avec un contrôle précis du positionnement.

<TODO : Ajouter une image ici -->

L'estampillage permet de superposer du contenu supplémentaire à des documents PDF existants. Les tampons permettent d'ajouter des informations, des étiquettes, des filigranes ou des annotations aux PDF. Utilisez des tampons pour ajouter des en-têtes et des pieds de page ou créer des filigranes personnalisés grâce aux fonctionnalités complètes de tamponnage d'IronPDF.

IronPDF fournit quatre tamponneurs : TextStamper, ImageStamper, HTMLStamper, et BarcodeStamper. HTMLStamper utilise toutes les fonctionnalités HTML avec un style CSS, similaire à la conversion de chaînes HTML en PDF.

Démarrage rapide : Tamponner du texte sur des PDF instantanément

Utilisez la classe TextStamper d'IronPDF pour ajouter des annotations textuelles, des filigranes ou des étiquettes aux documents PDF. L'exemple ci-dessous illustre l'apposition d'un tampon sur un PDF à l'aide de la méthode ApplyStamp.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPDF avec le gestionnaire de packages NuGet

    PM > Install-Package IronPdf

  2. Copiez et exécutez cet extrait de code.

    var pdf = new IronPdf.PdfDocument("input.pdf");
var stamper = new IronPdf.Editing.TextStamper()
{
    Text = "Confidential",
    FontSize = 50,
    Opacity = 50,
    VerticalAlignment = IronPdf.Editing.VerticalAlignment.Middle,
    HorizontalAlignment = IronPdf.Editing.HorizontalAlignment.Center
};
pdf.ApplyStamp(stamper);
pdf.SaveAs("stamped.pdf");

  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque C# pour tamponner du texte et une image
  2. Créez et configurez la classe de tamponneuse souhaitée
  3. Utilisez la méthode ApplyStamp pour appliquer le cachet au PDF
  4. Appliquer plusieurs tampons à l'aide de la méthode ApplyMultipleStamps
  5. Spécifiez des pages particulières pour appliquer les tampons


Comment estampiller du texte sur des PDF?

<TODO : Ajouter une image ici -->

Créez un objet TextStamper contenant toutes les configurations d'affichage. Transmettez l'objet TextStamper à la méthode ApplyStamp. La propriété Text définit le texte affiché. Configurez la famille de polices, le style de police et l'emplacement du cachet.

TextStamper offre des options de personnalisation étendues similaires à la gestion des polices dans les documents PDF. Utilisez les polices du système ou les polices Google en définissant UseGoogleFont sur true.

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs
using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create text stamper
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the text stamper
pdf.ApplyStamp(textStamper);

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

À quoi ressemble le PDF de sortie?

Comment créer des tampons de texte multilignes?

Utilisez la balise <br> pour le texte multiligne dans TextStamper. Par exemple, "ligne 1
ligne 2" produit "ligne 1" sur la première ligne et "ligne 2" sur la seconde. Cela permet de créer des tampons d'adresse ou des filigranes sur plusieurs lignes.

Comment estampiller des images sur des PDF?

Créez un objet ImageStamper et utilisez la méthode ApplyStamp pour appliquer des images à des documents. Le deuxième paramètre de la méthode accepte un index de page pour l'estampillage d'une ou de plusieurs pages. L'exemple ci-dessous reprend l'image de la page 1 du PDF.

ConseilsTous les index des pages suivent l'indexation à base zéro.

Pour les opérations complexes sur les images, explorez l'ajout d'images aux PDF ou le travail avec des images codées en base64.

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-image.cs
using IronPdf;
using IronPdf.Editing;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create image stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the image stamper
pdf.ApplyStamp(imageStamper, 0);

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

À quoi ressemble la sortie du tampon-image?

Quels sont les formats d'image pris en charge ?

<ImageStamper prend en charge les formats PNG, JPEG, GIF et SVG par le biais de références URI ou de chemins d'accès aux fichiers. Veillez à ce que la connectivité réseau soit correcte pour les images à distance. Pour les environnements Azure, envisagez d'utiliser des images provenant d'Azure Blob Storage.

Comment puis-je appliquer plusieurs tampons ?

Utilisez ApplyMultipleStamps pour appliquer plusieurs tampons en passant un tableau de tampons. Cette méthode permet de traiter efficacement plusieurs timbres en une seule opération.

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs
using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two text stampers
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

Stamper[] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply);

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

Qu'arrive-t-il lorsque les timbres se chevauchent?

Puis-je mélanger différents types de timbres ?

ApplyMultipleStamps accepte des tableaux contenant n'importe quel type de tampon. Combinez TextStamper, ImageStamper, HTMLStamper, et BarcodeStamper en une seule opération. Créer des mises en page de documents complexes avec des en-têtes, des pieds de page, des filigranes et des codes d'identification simultanément.

Comment puis-je contrôler l'emplacement des timbres ?

Définissez l'emplacement des timbres à l'aide d'une grille 3x3 comportant trois colonnes horizontales et trois lignes verticales. Choisissez l'alignement horizontal : gauche, centre, droite. Choisissez l'alignement vertical : haut, milieu, bas. Ajustez les décalages horizontaux et verticaux pour un positionnement précis. Voir l'image ci-dessous pour une représentation visuelle.

Grille d'alignement de l'API d'IronPDF montrant des options de positionnement horizontal/vertical et des exemples de décalage

Quelles sont les principales propriétés de positionnement ?

  • HorizontalAlignment : Alignement horizontal par rapport à la page. Défaut : HorizontalAlignment.Center.
  • VerticalAlignment : Alignement vertical par rapport à la page. Défaut : AlignementVertical.Moyen.
  • HorizontalOffset : décalage horizontal. Valeur par défaut : 0, unité : MeasurementUnit.Percentage. Les valeurs positives sont décalées vers la droite, les valeurs négatives vers la gauche.
  • VerticalOffset : Décalage vertical. Valeur par défaut : 0, unité : MeasurementUnit.Percentage. Les valeurs positives sont décalées vers le bas, les valeurs négatives vers le haut.

Comment définir des décalages précis?

Spécifiez HorizontalOffset et VerticalOffset à l'aide de la classe Length. L'unité de mesure par défaut est le pourcentage. Les unités disponibles sont les pouces, les millimètres, les centimètres, les pixels et les points. Cela permet un positionnement précis comme la définition de marges personnalisées dans les documents PDF.

Code

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-location.cs
using IronPdf.Editing;
using System;

// Create text stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Top,

    // Specify offsets
    HorizontalOffset = new Length(10),
    VerticalOffset = new Length(10),
};
$vbLabelText   $csharpLabel

Comment estampiller un contenu HTML?

Utilisez la classe HtmlStamper pour tamponner du texte et des images. HtmlStamper rend les conceptions HTML avec un style CSS, puis les tamponne sur des documents PDF. La propriété HtmlBaseUrl spécifie l'URL de base pour les chaînes HTML telles que les fichiers CSS et les images. Cette opération utilise le même moteur de rendu que la conversion de HTML en PDF.

Code

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs
using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two text stampers
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

Stamper[] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply);

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

Quelles sont les propriétés essentielles de HTML Stamper?

  • Html : fragment HTML à insérer dans votre PDF. Les références externes à JavaScript, CSS et aux images sont relatives à HtmlBaseUrl.
  • HtmlBaseUrl : URL de base pour les références externes aux fichiers CSS, JavaScript et images.
  • CssMediaType : Active les styles CSS Media="screen". Le réglage de AllowScreenCss=false rend les timbres en utilisant CSS media="print". Par défaut : PdfCssMediaType.Screen.

Pourquoi utiliser HTML Stamper plutôt que Text Stamper?

HTMLStamper fournit un support HTML et CSS complet pour les mises en page complexes, les polices multiples, les couleurs et les images intégrées dans un tampon. Idéal pour les filigranes ou les en-têtes à contenu riche. Elle doit maintenir une image de marque cohérente et fonctionner avec des conceptions CSS réactives.

Comment estampiller des BarCodes?

La classe BarcodeStamper appose des codes-barres directement sur des documents PDF existants. Prend en charge les types de codes-barres QRCode, Code128 et Code39.

Code

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs
using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create text stamper
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the text stamper
pdf.ApplyStamp(textStamper);

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

Quelles sont les options de configuration disponibles pour les BarCodes?

  • Value : valeur de la chaîne du code-barres.
  • BarcodeType : Type d'encodage prenant en charge QRCode, Code128 et Code39. Valeur par défaut : QRCode.
  • Width : Largeur du code-barres rendu en pixels. Défaut : 250px.
  • Hauteur : Hauteur du code-barres rendu en pixels. Défaut : 250px.

Quand dois-je utiliser chaque type de BarCode?

QRCode gère les URL et les grands ensembles de données (jusqu'à 4 296 caractères alphanumériques). Code128 convient aux données alphanumériques à haute densité. le Code39 fonctionne pour les combinaisons simples de chiffres ou de lettres majuscules. Tenez compte de la compatibilité de l'équipement de numérisation lors de la sélection des types de codes-barres.

Quelles sont les autres options de Stamper disponibles ?

Ces propriétés permettent de contrôler finement l'apparence et le comportement des timbres, de manière similaire à la création de filigranes personnalisés.

Comment contrôler l'apparence des timbres ?

  • Opacité : Contrôle la transparence. 0 est invisible, 100 est opaque.
  • Rotation : Fait pivoter le timbre dans le sens des aiguilles d'une montre de 0 à 360 degrés.
  • MaxWidth : Largeur maximale du timbre de sortie.
  • MaxHeight : Hauteur maximale du timbre de sortie.
  • MinWidth : Largeur minimale du timbre de sortie.
  • MinHeight : Hauteur minimale du timbre de sortie.
  • Hyperlink : Ajoute un lien hypertexte au clic sur les éléments estampillés. Remarque : les liens HTML (balises a) ne sont pas préservés par l'estampillage.
  • Echelle : Applique une échelle de pourcentage aux timbres. Valeur par défaut : 100 (aucun effet).
  • IsStampBehindContent : Place le cachet derrière le contenu. Le cachet peut être invisible si le contenu est opaque.
  • WaitFor : Attente d'événements ou de temps. Voir utiliser IronPDF pour retarder le rendu d'un PDF.
  • Timeout : Temps d'arrêt de rendu en secondes. Valeur par défaut : 60.

Quelles sont les propriétés les plus couramment utilisées ?

Opacity et IsStampBehindContent créent des filigranes. les fonctions Scale et Rotation permettent d'ajuster le positionnement visuel et la taille. Exemple :

// Create a semi-transparent watermark behind content
TextStamper watermark = new TextStamper()
{
    Text = "CONFIDENTIAL",
    FontSize = 60,
    FontColorCode = "#CCCCCC",
    Opacity = 25,
    Rotation = -45,
    IsStampBehindContent = true,
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center
};
// Create a semi-transparent watermark behind content
TextStamper watermark = new TextStamper()
{
    Text = "CONFIDENTIAL",
    FontSize = 60,
    FontColorCode = "#CCCCCC",
    Opacity = 25,
    Rotation = -45,
    IsStampBehindContent = true,
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center
};
$vbLabelText   $csharpLabel

Résumé

La fonctionnalité d'estampillage d'IronPDF permet d'ajouter du texte, des images, du contenu HTML et des codes-barres à des documents PDF existants. Quatre classes de stamper spécialisées avec des options de personnalisation étendues permettent de créer des documents professionnels avec des filigranes, des en-têtes, des pieds de page et des annotations. Le système de positionnement avec différentes unités de mesure et options d'alignement garantit un placement au pixel près. Utilisez des tampons de texte simples ou des mises en page HTML complexes avec un style CSS. L'API d'estampillage d'IronPDF offre la flexibilité et le contrôle nécessaires à la manipulation des PDF à l'échelle de l'entreprise.

Questions Fréquemment Posées

Comment ajouter un filigrane textuel à mes documents PDF en C# ?

Utilisez la classe TextStamper d'IronPDF pour ajouter des filigranes au texte. Créez un objet TextStamper, définissez des propriétés telles que Text, FontSize et Opacity, puis utilisez la méthode ApplyStamp. Vous pouvez positionner les filigranes en utilisant les propriétés VerticalAlignment et HorizontalAlignment pour un positionnement précis.

Puis-je ajouter des images en tant que tampons à des fichiers PDF existants ?

Oui, IronPDF fournit la classe ImageStamper pour ajouter des images aux PDF. Créez un objet ImageStamper, spécifiez le fichier image et utilisez la méthode ApplyStamp. Vous pouvez contrôler le positionnement et spécifier les pages à tamponner à l'aide de l'indexation des pages à base zéro.

Quels types de contenu peuvent être apposés sur les PDF ?

IronPDF prend en charge quatre types de tampons : TextStamper pour les annotations de texte et les filigranes, ImageStamper pour les images, HTMLStamper pour le contenu HTML avec un style CSS complet, et BarcodeStamper pour les codes-barres. Chaque classe de tampon offre un contrôle précis du positionnement.

Comment créer des tampons de texte multilignes ?

Utilisez la balise
dans la propriété TextStamper pour créer des tampons sur plusieurs lignes. Par exemple, "ligne 1
ligne 2" affichera le texte sur deux lignes distinctes, ce qui est parfait pour créer des tampons d'adresse ou des filigranes multilignes.

Puis-je utiliser des polices personnalisées lors de l'estampillage de texte sur des PDF ?

Oui, TextStamper dans IronPDF prend en charge à la fois les polices système et les polices Google. Définissez la propriété UseGoogleFont à true pour utiliser les polices Google, ou spécifiez n'importe quelle police système installée à l'aide de la propriété FontFamily pour un contrôle complet de la typographie.

Est-il possible d'ajouter des tampons à certaines pages seulement ?

Absolument. La méthode ApplyStamp accepte un paramètre d'index de page qui vous permet de marquer des pages spécifiques. IronPDF utilise une indexation basée sur le zéro, la page 1 correspond donc à l'index 0. Vous pouvez également utiliser ApplyMultipleStamps pour ajouter des tampons à plusieurs pages à la fois.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 17,012,929 | Version : 2025.12 vient de sortir