Wie man Stempel und Wasserzeichen zu PDFs in C# hinzufügt

How to Stamp Text & Image on PDFs

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

Das Stempeln von Text und Bildern in einer PDF-Datei beinhaltet das Überlagern zusätzlicher Inhalte auf ein bestehendes PDF-Dokument. Dieser Inhalt, oft als "Stempel" bezeichnet, kann Text, Bilder oder eine Kombination aus beidem sein. Stempel werden typischerweise verwendet, um Informationen, Etiketten, Wasserzeichen oder Anmerkungen zu einem PDF hinzuzufügen.

Es gibt insgesamt 4 Stempel, die in IronPdf verwendet werden können. Dieser Artikel wird über TextStamper, ImageStamper, HTMLStamper und BarcodeStamper sprechen. HTMLStamper ist besonders leistungsfähig, da es alle HTML-Funktionen zusammen mit CSS-Styling nutzen kann.

als-Überschrift:2(Kurzanleitung: Text auf PDFs sofort stempeln)

Diese Kurzanleitung zeigt, wie man mit IronPDF Text mit minimalem Aufwand auf eine PDF-Datei stempelt. Durch Nutzung der TextStamper Klasse können Entwickler einfach Textanmerkungen wie Wasserzeichen oder Etiketten zu jedem PDF-Dokument hinzufügen. Das folgende Beispiel zeigt eine einfache Implementierung des Stempelns von Text auf ein PDF mittels der ApplyStamp Methode, die einen schnellen und effizienten Stempelprozess gewährleistet.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    var pdf = new IronPdf.PdfDocument("input.pdf");
    var stamper = new IronPdf.TextStamper("Confidential", 50, 50);
    pdf.ApplyStamp(stamper);
    pdf.SaveAs("stamped.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Minimaler Workflow (5 Schritte)

  1. Laden Sie die C#-Bibliothek herunter, um Text und Bild zu stempeln
  2. Erstellen und konfigurieren Sie die gewünschte Stamper-Klasse
  3. Verwenden Sie die ApplyStamp Methode, um den Stempel auf das PDF anzuwenden
  4. Wenden Sie mehrere Stempel mit der ApplyMultipleStamps Methode an
  5. Geben Sie bestimmte Seiten an, um die Stempel anzuwenden


Beispiel für Textstempel

Erstellen Sie zunächst ein Objekt aus der TextStamper Klasse. Dieses Objekt enthält alle Konfigurationen, um festzulegen, wie unser Textstempel angezeigt werden soll. Übergeben Sie das TextStamper-Objekt an die ApplyStamp Methode. Die Text Eigenschaft wird der angezeigte Text sein. Außerdem können wir Schriftfamilie, Schriftstil und die Position des Stempels festlegen.

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

Private renderer As New ChromePdfRenderer()

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

' Create text stamper
Private textStamper As New TextStamper() With {
	.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

Ausgangs-PDF

Um mehrzeiligen Text im TextStamper zu erreichen, verwenden Sie das <br> Tag wie in HTML. Zum Beispiel führt "Zeile 1
Zeile 2" zu "Zeile 1" in der ersten Zeile und "Zeile 2" in der zweiten Zeile.


Beispiel für Bildstempel

Ähnlich wie beim Textstempel erstellen wir zunächst ein Objekt aus der ImageStamper Klasse und verwenden dann die ApplyStamp Methode, um das Bild auf das Dokument anzuwenden. Der zweite Parameter dieser Methode akzeptiert auch einen Seitenindex, der verwendet werden kann, um den Stempel auf eine einzelne oder mehrere Seiten anzuwenden. Im folgenden Beispiel geben wir an, dass das Bild auf Seite 1 des PDFs gestempelt werden soll.

TippsAlle Seitenindizes folgen der nullbasierten Indizierung.

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

Private renderer As New ChromePdfRenderer()

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

' Create image stamper
Private imageStamper As New ImageStamper(New Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg")) With {.VerticalAlignment = VerticalAlignment.Top}

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

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

Ausgangs-PDF


Mehrere Stempel anwenden

Verwenden Sie die ApplyMultipleStamps Methode, um mehrere Stempel auf das Dokument durch Übergeben eines Arrays von Stampern anzuwenden.

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

Private renderer As New ChromePdfRenderer()

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

' Create two text stampers
Private stamper1 As New TextStamper() With {
	.Text = "Text stamp 1",
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalAlignment = HorizontalAlignment.Left
}

Private stamper2 As New TextStamper() With {
	.Text = "Text stamp 2",
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalAlignment = HorizontalAlignment.Right
}

Private stampersToApply() As Stamper = { stamper1, stamper2 }

' Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply)

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

Ausgangs-PDF


Stempelposition

Um die Platzierung des Stempels zu definieren, nutzen wir ein 3x3 Raster mit drei horizontalen Spalten und drei vertikalen Reihen. Sie haben Wahlmöglichkeiten für die horizontale Ausrichtung: links, zentriert und rechts sowie für die vertikale Ausrichtung: oben, Mitte und unten. Für zusätzliche Präzision können Sie sowohl horizontale als auch vertikale Versätze für jede Position anpassen. Bitte beziehen Sie sich auf das unten stehende Bild für eine visuelle Darstellung dieses Konzepts.

class="content-img-align-center">
class="center-image-wrapper"> Stempelposition
  • HorizontalAlignment: Die horizontale Ausrichtung des Stempels relativ zur Seite. Die Standardeinstellung ist HorizontalAlignment.Center.
  • VerticalAlignment: Die vertikale Ausrichtung des Stempels relativ zur Seite. Die Standardeinstellung ist VerticalAlignment.Middle.
  • HorizontalOffset: Der horizontale Versatz. Der Standardwert ist 0 und die Standardmaßeinheit ist IronPdf.Editing.MeasurementUnit.Percentage. Positive Werte geben einen Versatz in die rechte Richtung an, während negative Werte einen Versatz in die linke Richtung angeben.
  • VerticalOffset: Der vertikale Versatz. Der Standardwert ist 0 und die Standardmaßeinheit ist IronPdf.Editing.MeasurementUnit.Percentage. Positive Werte geben einen Versatz in die Abwärtsrichtung an, während negative Werte einen Versatz in die Aufwärtsrichtung angeben.

Um die HorizontalOffset und VerticalOffset Eigenschaften anzugeben, instanziieren wir die Length Klasse. Die Standardmaßeinheit für Länge ist ein Prozentsatz, aber sie ist auch in der Lage, Maßeinheiten wie Zoll, Millimeter, Zentimeter, Pixel und Punkte zu verwenden.

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),
};
Imports IronPdf.Editing
Imports System

' Create text stamper
Private imageStamper As New ImageStamper(New Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg")) With {
	.HorizontalAlignment = HorizontalAlignment.Center,
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalOffset = New Length(10),
	.VerticalOffset = New Length(10)
}
$vbLabelText   $csharpLabel

Stempel HTML Beispiel

Es gibt eine andere Stamper-Klasse, die wir verwenden können, um sowohl Text als auch Bilder zu stempeln. Die HtmlStamper Klasse kann verwendet werden, um HTML-Designs mit CSS-Styling zu rendern und dann auf das PDF-Dokument zu stempeln. Die HtmlBaseUrl Eigenschaft wird verwendet, um die Basis-URL für die HTML-String-Assets wie CSS- und Bilddateien anzugeben.

Code

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

ChromePdfRenderer renderer = new ChromePdfRenderer();

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

// Create HTML stamper
HtmlStamper htmlStamper = new HtmlStamper()
{
    Html = @"<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the HTML stamper
pdf.ApplyStamp(htmlStamper);

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

Private renderer As New ChromePdfRenderer()

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

' Create HTML stamper
Private htmlStamper As New HtmlStamper() With {
	.Html = "<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
	.VerticalAlignment = VerticalAlignment.Top
}

' Stamp the HTML stamper
pdf.ApplyStamp(htmlStamper)

pdf.SaveAs("stampHtml.pdf")
$vbLabelText   $csharpLabel
  • Html: Das auf Ihr PDF zu stempelnde HTML-Fragment. Alle externen Verweise auf JavaScript-, CSS- und Bilddateien werden relativ zur HtmlBaseUrl Eigenschaft der Stamper Klasse sein.
  • HtmlBaseUrl: Die HTML-Basis-URL, für die Verweise auf externe CSS-, Javascript- und Bilddateien relativ sein werden.
  • CssMediaType: Ermöglicht Media="screen" CSS Styles und Stylesheets. Durch das Setzen von AllowScreenCss=false rendert IronPdf den Stempel aus HTML unter Verwendung von CSS für media="print", als ob eine Webseite im Druckdialog eines Browsers gedruckt wird. Der Standardwert ist PdfCssMediaType.Screen.

Stempel Barcode Beispiel

Die BarcodeStamper Klasse kann verwendet werden, um Barcodes direkt auf das bestehende PDF-Dokument zu stempeln. Der Stamper unterstützt Barcode-Typen einschließlich QRCode, Code128 und Code39.

Code

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

ChromePdfRenderer renderer = new ChromePdfRenderer();

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

// Create barcode stamper
BarcodeStamper barcodeStamper = new BarcodeStamper("IronPdf!!", BarcodeEncoding.Code39)
{
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the barcode stamper
pdf.ApplyStamp(barcodeStamper);

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

Private renderer As New ChromePdfRenderer()

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

' Create barcode stamper
Private barcodeStamper As New BarcodeStamper("IronPdf!!", BarcodeEncoding.Code39) With {.VerticalAlignment = VerticalAlignment.Top}

' Stamp the barcode stamper
pdf.ApplyStamp(barcodeStamper)

pdf.SaveAs("stampBarcode.pdf")
$vbLabelText   $csharpLabel
  • Wert: Der String-Wert des Barcodes.
  • BarcodeType: Der Codierungstyp für den Barcode, mit unterstützten Typen einschließlich QRCode, Code128 und Code39. Der Standardwert ist QRCode.
  • Breite: Die Breite des gerenderten Barcodes in Pixeln. Der Standardwert ist 250px.
  • Höhe: Die Höhe des gerenderten Barcodes in Pixeln. Der Standardwert ist 250px.

Erkunden Sie Stamper-Optionen

Zusätzlich zu den oben genannten und erklärten Optionen gibt es unten weitere Optionen, die für die Stamper-Klassen verfügbar sind.

  • Opazität: Ermöglicht es dem Stempel, transparent zu sein. 0 ist vollständig unsichtbar, 100 ist vollständig opak.
  • Drehung: Dreht den Stempel im Uhrzeigersinn von 0 bis 360 Grad wie angegeben.
  • MaxWidth: Die maximale Breite des Ausgabestempels.
  • MaxHeight: Die maximale Höhe des Ausgabestempels.
  • MinWidth: Die minimale Breite des Ausgabestempels.
  • MinHeight: Die minimale Höhe des Ausgabestempels.
  • Hyperlink: Macht die gestempelten Elemente dieses Stampers zum einem Klick-Hyperlink. Hinweis: HTML-Links, die durch Link(a) Tags erstellt werden, werden durch den Stempelprozess nicht beibehalten.
  • Skalierung: Wendet eine prozentuale Skalierung auf die Stempel an, um sie größer oder kleiner zu machen. Der Standardwert ist 100 (Prozent), was keine Wirkung hat.
  • IsStampBehindContent: Auf true setzen, um den Stempel hinter dem Inhalt anzuwenden. Wenn der Inhalt opak ist, kann der Stempel unsichtbar sein.
  • WartenAuf: Ein praktischer Wrapper, um auf verschiedene Ereignisse zu warten oder einfach eine Zeitspanne zu warten.
  • Timeout: Rendering Timeout in Sekunden. Der Standardwert ist 60.

Häufig gestellte Fragen

Was ist der Zweck des Stempelns von Text und Bildern in PDFs?

Das Stempeln von Text und Bildern in PDFs ermöglicht es Ihnen, zusätzlichen Inhalt wie Etiketten, Wasserzeichen oder Anmerkungen auf bestehende PDF-Dokumente zu legen. Dies wird durch die Verwendung verschiedener Stamper-Klassen von IronPDF erreicht, wie z.B. `TextStamper` und `ImageStamper`.

Wie kann ich anfangen, Text und Bilder in PDFs mit C# zu stempeln?

Um mit dem Stempeln von Text und Bildern in PDFs mit C# zu beginnen, installieren Sie die IronPDF-Bibliothek über NuGet, konfigurieren die entsprechende Stamper-Klasse und verwenden Sie die ApplyStamp-Methode, um den Stempel auf das PDF anzuwenden.

Welche Arten von Stamper kann ich für das Stempeln von PDFs in IronPDF verwenden?

IronPDF bietet mehrere Stamper-Typen: `TextStamper` für Text, `ImageStamper` für Bilder, `HTMLStamper` für HTML-Inhalte mit CSS und `BarcodeStamper` für QRCode und andere Barcode-Typen.

Wie wende ich einen Textstempel auf eine bestimmte Seite in einem PDF mit C# an?

In IronPDF können Sie einen Textstempel auf eine bestimmte Seite anwenden, indem Sie ein `TextStamper`-Objekt erstellen, seine Eigenschaften konfigurieren und die ApplyStamp-Methode mit dem Seitenindexparameter verwenden, um bestimmte Seiten anzuvisieren.

Ist es möglich, mehrere Stempel gleichzeitig auf ein PDF anzuwenden?

Ja, IronPDF ermöglicht es Ihnen, mehrere Stempel gleichzeitig anzuwenden, indem Sie die ApplyMultipleStamps-Methode verwenden, bei der Sie ein Array von konfigurierten Stamper-Objekten übergeben können.

Welche Anpassungsoptionen gibt es für die Positionierung von Stempeln in PDFs?

IronPDF ermöglicht die Anpassung der Stempelpositionierung mithilfe eines 3x3 Gitters für Ausrichtungsoptionen wie links, zentriert, rechts für horizontal und oben, Mitte, unten für vertikale Positionen sowie zusätzliche Versatzeinstellungen.

Kann HTML-Inhalt zum Stempeln auf PDFs verwendet werden?

Ja, die `HTMLStamper`-Klasse von IronPDF ermöglicht es, HTML-Inhalte mit CSS-Styling auf PDFs zu stempeln und bietet eine vielseitige Lösung für komplexe Designs.

Welche Barcode-Typen unterstützt IronPDF für das Stempeln auf PDFs?

IronPDF's `BarcodeStamper` unterstützt mehrere Barcode-Typen, einschließlich QRCode, Code128 und Code39, sodass Sie Barcode-Informationen in Ihre PDF-Dokumente integrieren können.

Welche erweiterten Optionen bietet IronPDF für die Anpassung von PDF-Stempeln?

IronPDF bietet erweiterte Anpassungsoptionen für PDF-Stempel, einschließlich Eigenschaften wie Opazität, Rotation, MaxWidth, MaxHeight, Hyperlink, Skalierung, IsStampBehindContent, WaitFor und Timeout.

Was sind häufige Tipps zur Fehlerbehebung beim Stempeln von PDFs mit IronPDF?

Stellen Sie sicher, dass Sie die korrekte Version von IronPDF installiert haben, überprüfen Sie die Konfigurationen Ihrer Stamper-Objekte und prüfen Sie, ob Ihr Code die Seitenindizes oder Bereiche korrekt angibt, auf denen Stempel angewendet werden.

Ist IronPDF vollständig kompatibel mit .NET 10 zum Einfügen von Text und Bildern in PDFs?

Ja – IronPDF ist vollständig mit .NET 10 kompatibel. Stempelfunktionen wie `TextStamper`, `ImageStamper`, `ApplyStamp`, `ApplyMultipleStamps` sowie Ausrichtungs- und Anpassungsoptionen funktionieren in .NET 10-Projekten ohne zusätzliche Konfiguration. Diese Funktionen werden unter .NET 10 auf allen Plattformen und in allen Projekttypen unterstützt.

Chaknith Bin
Software Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat umfassende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Einblicke aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentationen und einem insgesamt besseren Erlebnis bei.
Bereit anzufangen?
Nuget Downloads 16,154,058 | Version: 2025.11 gerade veröffentlicht