Text und Bilder in PDFs stempeln mit C# und IronPDF

Wie sieht die PDF-Ausgabe aus?

Wie kann ich mehrzeilige Textstempel erstellen?

Verwenden Sie das <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 sieht die Ausgabe des Bildstempels aus?

Welche Bildformate werden unterstützt?

ImageStamper unterstützt PNG, JPEG, GIF und SVG über 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.

Was passiert, wenn sich Stempel überschneiden?

Kann ich verschiedene Stempeltypen mischen?

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

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),
};

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)
}

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");

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")

Was sind die wesentlichen Eigenschaften von HTML Stamper?

• Html: HTML-Fragment zum Einfügen in Ihre PDF-Datei. Externe Verweise auf JavaScript, CSS und Bilder sind relativ zu HtmlBaseUrl.
• HtmlBaseUrl: Basis-URL für externe CSS-, JavaScript und Bilddateiverweise.
• CssMediaType: Aktiviert CSS-Stile für Media="screen". Die Einstellung AllowScreenCss=false rendert Stempel mithilfe von CSS media="print". Standard: PdfCssMediaType.Screen.

Warum HTML Stamper statt Text Stamper verwenden?

HTMLStamper bietet volle HTML- und CSS-Unterstützung für komplexe Layouts, mehrere Schriftarten, Farben und eingebettete Bilder in einem einzigen Stempel. Ideal für Wasserzeichen oder Überschriften mit umfangreichem Inhalt. Der Text muss ein einheitliches Branding aufweisen und mit responsiven CSS-Designs arbeiten.

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");

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")

Welche Konfigurationsoptionen sind für BarCodes verfügbar?

• Value: Zeichenkettenwert des Barcodes.
• BarcodeType: Kodierungstyp, der QRCode, Code128 und Code39 unterstützt. Standard: QRCode.
• Width: Gerenderte Barcode-Breite in Pixeln. Standard: 250px.
• Height: Gerenderte Barcode-Höhe in Pixeln. 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 funktioniert für einfache Zahlen- oder Großbuchstabenkombinationen. Berücksichtigen Sie bei der Auswahl der Barcodetypen die Kompatibilität der Scangeräte.

Wie kontrolliere ich das Erscheinungsbild von Stempeln?

• Opacity: 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: Minimale Höhe des Ausgabestempels.
• Hyperlink: Fügt gestempelten Elementen einen Hyperlink hinzu, der beim Anklicken aktiviert wird. Hinweis: HTML-Links (a-Tags) bleiben beim Stempeln nicht erhalten.
• Scale: Wendet eine Prozentskala auf Briefmarken an. Standardwert: 100 (keine Auswirkung).
• IsStampBehindContent: Platziert einen Stempel hinter dem Inhalt. Der Stempel kann unsichtbar sein, wenn der Inhalt undurchsichtig ist.
• WaitFor: Wartet auf Ereignisse oder Zeit. Siehe Verwendung von WaitFor zum Verzögern des PDF-Renderings .
• Timeout: Render-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
};

' Create a semi-transparent watermark behind content
Dim watermark As New TextStamper() With {
    .Text = "CONFIDENTIAL",
    .FontSize = 60,
    .FontColorCode = "#CCCCCC",
    .Opacity = 25,
    .Rotation = -45,
    .IsStampBehindContent = True,
    .VerticalAlignment = VerticalAlignment.Middle,
    .HorizontalAlignment = HorizontalAlignment.Center
}