1. IronPDF
  2. Anleitungen
  3. Text- & Bildstempel
Wie man Stempel und Wasserzeichen zu PDFs in C# hinzufügt

Markieren von Text und Bildern in PDFs mit C# und IronPDF

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

IronPDF stempelt in C# mit den Klassen TextStamper, ImageStamper, HTMLStamper und BarCodeStamper Text, Bilder, HTML-Inhalte und Barcodes in bestehende PDF-Dokumente mit präziser Positionskontrolle.

Beim Stempeln werden zusätzliche Inhalte in bestehende PDF-Dokumente eingefügt. Stempel fügen Informationen, Etiketten, Wasserzeichen oder Anmerkungen zu PDFs hinzu. Verwenden Sie Stempel zum Hinzufügen von Kopf- und Fußzeilen oder zum Erstellen benutzerdefinierter Wasserzeichen mit den umfassenden Stempelfunktionen von IronPDF.

IronPDF bietet vier Stampers: TextStamper, ImageStamper, HTMLStamper, und BarcodeStamper. HTMLStamper nutzt alle HTML-Funktionen mit CSS-Styling, ähnlich der Konvertierung von HTML-Strings in PDF.

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

Verwenden Sie die Klasse TextStamper von IronPDF, um PDF-Dokumente mit Textanmerkungen, Wasserzeichen oder Etiketten zu versehen. Das folgende Beispiel zeigt, wie mit der Methode ApplyStamp Text in eine PDF-Datei gestempelt wird.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    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. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

  1. Laden Sie die C#-Bibliothek zum Stempeln von Text und Bild herunter
  2. Erstellen und konfigurieren Sie die gewünschte Stamper-Klasse
  3. Verwenden Sie die Methode ApplyStamp, um den Stempel auf die PDF-Datei anzuwenden
  4. Mehrere Stempel mit der Methode ApplyMultipleStamps anwenden
  5. Geben Sie Seiten an, auf die die Stempel angewendet werden.


Wie kann ich Text in PDFs stempeln?

Erstellen Sie ein TextStamper-Objekt, das alle Anzeigekonfigurationen enthält. Übergeben Sie das TextStamper-Objekt an die Methode ApplyStamp. Die Eigenschaft Text legt den angezeigten Text fest. Konfigurieren Sie die Schriftfamilie, das Schriftstyling und die Position des Stempels.

TextStamper bietet umfangreiche Anpassungsmöglichkeiten, ähnlich der Verwaltung von Schriftarten in PDF-Dokumenten. Verwenden Sie Systemschriftarten oder Google Fonts, indem Sie UseGoogleFont auf true setzen.

: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

Wie sieht die PDF-Ausgabe aus?

Wie kann ich mehrzeilige Textstempel erstellen?

Verwenden Sie den <br>-Tag für mehrzeiligen Text in TextStamper. Ein Beispiel: "Zeile 1
Zeile 2" ergibt "Zeile 1" in der ersten Zeile und "Zeile 2" in der zweiten Zeile. So entstehen Adressstempel oder mehrzeilige Wasserzeichen.

Wie stemple ich Bilder in PDFs?

Erstellen Sie ein ImageStamper-Objekt und verwenden Sie die Methode ApplyStamp, um Bilder auf Dokumente anzuwenden. Der zweite Parameter der Methode akzeptiert einen Seitenindex zum Stempeln einzelner oder mehrerer Seiten. Das unten stehende Beispiel prägt das Bild auf Seite 1 der PDF-Datei.

TippsAlle Seitenindizes folgen der nullbasierten Indizierung.

Für komplexe Bildoperationen können Sie Bilder zu PDFs hinzufügen oder mit base64-kodierten Bildern arbeiten.

: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

Wie sieht die Ausgabe des Bildstempels aus?

Welche Bildformate werden unterstützt?

ImageStamper unterstützt PNG, JPEG, GIF und SVG durch URI-Referenzen oder Dateipfade. Sicherstellung einer ordnungsgemäßen Netzwerkkonnektivität für entfernte Bilder. Für Azure-Umgebungen sollten Sie Bilder aus Azure Blob Storage verwenden.

Wie kann ich mehrere Stempel aufbringen?

Verwenden Sie ApplyMultipleStamps, um mehrere Stempel anzuwenden, indem Sie ein Array von Stampern übergeben. Mit dieser Methode werden mehrere Briefmarken in einem einzigen Arbeitsgang effizient verarbeitet.

: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

Was passiert, wenn sich Stempel überschneiden?

Kann ich verschiedene Stempeltypen mischen?

ApplyMultipleStamps akzeptiert Arrays mit beliebigen Stempeltypen. Kombinieren Sie TextStamper, ImageStamper, HTMLStamper und BarcodeStamper in einem Vorgang. Erstellen Sie komplexe Dokumentenlayouts mit Kopf- und Fußzeilen, Wasserzeichen und Identifikationscodes gleichzeitig.

Wie kontrolliere ich die Position des Stempels?

Definieren Sie die Platzierung der Marken in einem 3x3-Raster mit drei horizontalen Spalten und drei vertikalen Zeilen. Wählen Sie die horizontale Ausrichtung: links, mittig, rechts. Wählen Sie die vertikale Ausrichtung: oben, Mitte, unten. Passen Sie horizontale und vertikale Versätze für eine präzise Positionierung an. Das Bild unten zeigt eine visuelle Darstellung.

IronPDF Stamping API Ausrichtungsraster mit horizontalen/vertikalen Positionierungsoptionen und Offset-Beispielen

Was sind die wichtigsten Positionierungseigenschaften?

  • HorizontalAlignment: Horizontale Ausrichtung relativ zur Seite. Standard: HorizontalAlignment.Center.
  • VerticalAlignment: Vertikale Ausrichtung relativ zur Seite. Standard: VerticalAlignment.Middle.
  • HorizontalOffset: Horizontaler Versatz. Standardwert: 0, Einheit: MeasurementUnit.Percentage. Positive Werte werden nach rechts, negative Werte nach links verschoben.
  • VerticalOffset: Vertikaler Versatz. Standardwert: 0, Einheit: MeasurementUnit.Percentage. Positive Werte werden nach unten, negative Werte nach oben verschoben.

Wie stelle ich genaue Offsets ein?

Geben Sie HorizontalOffset und VerticalOffset mithilfe der Klasse Length an. Die Standardmaßeinheit ist Prozent. Zu den verfügbaren Einheiten gehören Zoll, Millimeter, Zentimeter, Pixel und Punkte. Dies ermöglicht eine präzise Positionierung wie Einstellung von benutzerdefinierten Rändern in PDF-Dokumenten.

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

Wie stemple ich HTML-Inhalte?

Verwenden Sie die Klasse HtmlStamper, um Text und Bilder zu stempeln. HtmlStamper rendert HTML-Designs mit CSS-Styling und stempelt sie dann in PDF-Dokumente. Die Eigenschaft HtmlBaseUrl gibt die Basis-URL für HTML-String-Assets wie CSS- und Bilddateien an. Dabei wird die gleiche Rendering-Engine verwendet wie bei der Konvertierung von HTML in 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

Was sind die wesentlichen Eigenschaften von HTML Stamper?

  • Html: HTML-Fragment zum Einfügen in Ihr PDF. Externe Verweise auf JavaScript, CSS und Bilder sind relativ zu HtmlBaseUrl.
  • HtmlBaseUrl: Basis-URL für externe CSS-, JavaScript- und Bilddateiverweise.
  • CssMediaType: Ermöglicht Media="screen" CSS-Stile. Die Einstellung AllowScreenCss=false rendert Briefmarken mit CSS media="print". Standard: PdfCssMediaType.Screen.

Warum HTML Stamper statt Text Stamper verwenden?

HTMLStamper bietet vollständige HTML- und CSS-Unterstützung für komplexe Layouts, mehrere Schriftarten, Farben und eingebettete Bilder in einem Stempel. Ideal für Wasserzeichen oder Kopfzeilen mit umfangreichen Inhalten. Der Text muss ein einheitliches Branding aufweisen und mit responsiven CSS-Designs arbeiten.

Wie stemple ich BarCodes?

Die Klasse BarCodeStamper stempelt Barcodes direkt auf vorhandene PDF-Dokumente. Unterstützt die Barcodetypen QRCode, Code128 und 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

Welche Konfigurationsoptionen sind für BarCodes verfügbar?

  • Wert: String-Wert des Barcodes.
  • BarcodeType: Codierungstyp, der QRCode, Code128 und Code39 unterstützt. Voreinstellung: QRCode.
  • Breite: Breite des gerenderten Barcodes in Pixel. Standard: 250px.
  • Höhe: Höhe des gerenderten Barcodes in Pixel. Standard: 250px.

Wann sollte ich jeden BarCode-Typ verwenden?

QRCode verarbeitet URLs und große Datensätze (bis zu 4.296 alphanumerische Zeichen). Code128 eignet sich für alphanumerische Daten mit hohen Dichteanforderungen. Code39 eignet sich für einfache Kombinationen aus Ziffern und Großbuchstaben. Berücksichtigen Sie bei der Auswahl der Barcodetypen die Kompatibilität der Scangeräte.

Welche zusätzlichen Stamper-Optionen sind verfügbar?

Mit diesen Eigenschaften lassen sich Aussehen und Verhalten von Stempeln genau steuern, ähnlich wie beim Erstellen eigener Wasserzeichen.

Wie kontrolliere ich das Erscheinungsbild von Stempeln?

  • Durchsichtigkeit: Steuert die Transparenz. 0 ist unsichtbar, 100 ist undurchsichtig.
  • Rotation: Dreht den Stempel im Uhrzeigersinn von 0 bis 360 Grad.
  • MaxWidth: Maximale Breite des Ausgabestempels.
  • MaxHeight: Maximale Höhe des Ausgabestempels.
  • MinWidth: Minimale Breite des Ausgabestempels.
  • MinHeight: Mindesthöhe des Ausgabestempels.
  • Hyperlink: Fügt bei einem Klick einen Hyperlink zu gestempelten Elementen hinzu. Hinweis: HTML-Links (a-Tags) bleiben beim Stempeln nicht erhalten.
  • Skala: Wendet eine prozentuale Skala auf Briefmarken an. Standardwert: 100 (keine Auswirkung).
  • IsStampBehindContent: Setzt den Stempel hinter den Inhalt. Der Stempel kann unsichtbar sein, wenn der Inhalt undurchsichtig ist.
  • WaitFor: Wartet auf Ereignisse oder Zeit. Siehe Verwendung von WaitFor zur Verzögerung des PDF-Renderings.
  • Timeout: Rendering Timeout in Sekunden. Standard: 60.

Welche Eigenschaften werden am häufigsten verwendet?

Opacity und IsStampBehindContent erzeugen Wasserzeichen. Scale und Rotation passen die visuelle Positionierung und Größe an. Beispiel:

// 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

Zusammenfassung

Die Stempelfunktion von IronPDF fügt Text, Bilder, HTML-Inhalte und Barcodes zu bestehenden PDF-Dokumenten hinzu. Vier spezialisierte Stempelklassen mit umfangreichen Anpassungsmöglichkeiten erstellen professionelle Dokumente mit Wasserzeichen, Kopf- und Fußzeilen sowie Anmerkungen. Das Positionierungssystem mit verschiedenen Maßeinheiten und Ausrichtungsoptionen gewährleistet eine pixelgenaue Platzierung. Verwenden Sie einfache Textstempel oder komplexe HTML-Layouts mit CSS-Styling. Die Stempel-API von IronPDF bietet Flexibilität und Kontrolle für die PDF-Bearbeitung auf Unternehmensebene.

Häufig gestellte Fragen

Wie füge ich meinen PDF-Dokumenten in C# ein Textwasserzeichen hinzu?

Verwenden Sie die TextStamper-Klasse von IronPDF, um Textwasserzeichen hinzuzufügen. Erstellen Sie ein TextStamper-Objekt, legen Sie Eigenschaften wie Text, FontSize und Opacity fest und verwenden Sie dann die Methode ApplyStamp. Sie können Wasserzeichen mithilfe der Eigenschaften VerticalAlignment und HorizontalAlignment präzise platzieren.

Kann ich Bilder als Stempel in bestehende PDF-Dateien einfügen?

Ja, IronPDF bietet die ImageStamper-Klasse zum Hinzufügen von Bildern zu PDFs. Erstellen Sie ein ImageStamper-Objekt, geben Sie die Bilddatei an, und verwenden Sie die Methode ApplyStamp. Sie können die Positionierung steuern und angeben, welche Seiten gestempelt werden sollen, indem Sie die nullbasierte Seitenindexierung verwenden.

Welche Arten von Inhalten können in PDFs eingeprägt werden?

IronPDF unterstützt vier Arten von Stempeln: TextStamper für Textanmerkungen und Wasserzeichen, ImageStamper für Bilder, HTMLStamper für HTML-Inhalte mit vollständigem CSS-Styling und BarcodeStamper für Barcodes. Jede Stempelklasse bietet eine präzise Steuerung der Positionierung.

Wie kann ich mehrzeilige Textstempel erstellen?

Verwenden Sie das
-Tag innerhalb der TextStamper-Eigenschaft Text, um mehrzeilige Stempel zu erstellen. Mit "Zeile 1
Zeile 2" wird beispielsweise Text in zwei separaten Zeilen angezeigt, was sich ideal für die Erstellung von Adressstempeln oder mehrzeiligen Wasserzeichen eignet.

Kann ich beim Stempeln von Text auf PDFs benutzerdefinierte Schriftarten verwenden?

Ja, TextStamper in IronPDF unterstützt sowohl Systemschriftarten als auch Google Fonts. Setzen Sie die Eigenschaft UseGoogleFont auf true, um Google Fonts zu verwenden, oder geben Sie eine beliebige installierte Systemschriftart mit der Eigenschaft FontFamily an, um die Typografie vollständig zu steuern.

Ist es möglich, Stempel nur auf bestimmten Seiten anzubringen?

Unbedingt. Die Methode ApplyStamp akzeptiert einen Seitenindex-Parameter, mit dem Sie bestimmte Seiten stempeln können. IronPDF verwendet eine nullbasierte Indizierung, sodass Seite 1 den Index 0 hat. Sie können auch ApplyMultipleStamps verwenden, um mehrere Seiten auf einmal zu stempeln.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht