Stamp Text & Image on PDFs using C# and IronPDF
IronPDF, TextStamper, ImageStamper, HTMLStamper ve BarcodeStamper sınıflarını kullanarak C# içinde mevcut PDF belgelerine metin, resimler, HTML içerik ve barkodlar eklerken hassas konumlandırma kontrolü sağlar.
Damgalama, mevcut PDF belgelerine ek içerik ekler. Damgalar PDF'lere bilgi, etiket, filigran veya açıklamalar ekler. IronPDF'in kapsamlı damgalama yetenekleri ile başlık ve altbilgi eklemek veya özel filigranlar oluşturmak için damgalar kullanın.
IronPDF, dört mühürleme sınıfı sağlar: TextStamper, ImageStamper, HTMLStamper ve BarcodeStamper. HTMLStamper, HTML özelliklerini CSS stili ile tamamen kullanır, tıpkı HTML dizelerini PDF'ye dönüştürme gibi.
Hızlı Başlangıç: Hemen PDF'lere Metin Damgası
PDF belgelerine metin açıklamaları, filigranlar veya etiketler eklemek için IronPDF'in TextStamper sınıfını kullanın. Aşağıdaki örnek, ApplyStamp yöntemi kullanılarak bir PDF'ye metin eklemeyi göstermektedir.
-
NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronPdf yükleyin
PM > Install-Package IronPdf -
Bu kod parçasını kopyalayıp çalıştırın.
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"); -
Canlı ortamınızda test etmek için dağıtın
Bugün projenizde IronPDF kullanmaya başlayın ücretsiz deneme ile
Minimal Is Akisi (5 adimda)
- Metin ve görüntü damgalamak için C# kütüphanesini indirin
- İstediğiniz damga sınıfını oluşturun ve yapılandırın
ApplyStampyöntemini kullanarak damgayı PDF'ye uygulayınApplyMultipleStampsyöntemiyle birden fazla damga uygulayın- Damga uygulamak için belirli sayfaları belirtin
PDF'lere Nasıl Metin Damgalarım?
Tüm görüntüleme yapılandırmalarını içeren bir TextStamper nesnesi oluşturun. TextStamper nesnesini ApplyStamp yöntemine geçirin. Text özelliği görüntülenen metni ayarlar. Yazı tipi ailesini, yazı tipi stilini ve damga yerini yapılandırın.
TextStamper, PDF belgelerinde yazı tiplerini yönetme gibi geniş özelleştirme seçenekleri sunar. UseGoogleFont ayarını true yaparak sistem yazı tiplerini veya Google Yazı Tiplerini kullanın.
: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")
Çıktı PDF'i Nasıl Görünür?
Çok Satırlı Metin Damgalarını Nasıl Oluşturabilirim?
<br> etiketini TextStamper içinde çok satırlı metin için kullanın. Örneğin, "satır 1
satır 2" , "satır 1" ilk satırda ve "satır 2" ikinci satırda üretir. Bu, adres damgaları veya çok satırlı filigranlar oluşturur.
PDF'lere Nasıl Görüntü Damgalarım?
Bir ImageStamper nesnesi oluşturun ve belgelerde resim uygulamak için ApplyStamp yöntemini kullanın. Yöntemin ikinci parametresi, tek veya birden fazla sayfa damgalamak için bir sayfa indeksini kabul eder. Aşağıdaki örnek, resmi PDF'nin 1. sayfasına damgalar.
Karmaşık görüntü işlemleri için PDF'lere görüntü ekleme veya base64 şifreli görüntülerle çalışma seçeneklerini keşfedin.
: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")
Görüntü Damgası Çıktısı Nasıl Görünür?
Hangi Resim Formatları Desteklenir?
ImageStamper, URI referansları veya dosya yolları aracılığıyla PNG, JPEG, GIF ve SVG'yi destekler. Uzaktaki görseller için uygun ağ bağlantısını sağladığınızdan emin olun. Azure ortamları için, Azure Blob Storage'dan gelen görselleri kullanmayı düşünün.
Birden Fazla Damga Nasıl Uygularım?
Bir dizi mühürleyici geçirerek birden fazla mühür uygulamak için ApplyMultipleStamps kullanın. Bu yöntem, tek bir işlemde birkaç damgayı verimli bir şekilde işler.
: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")
Damgalar Çakıştığında Ne Olur?
Farklı Damga Türlerini Karıştırabilir miyim?
ApplyMultipleStamps, herhangi bir mühürleyici türünü içeren dizileri kabul eder. Bir işlemi TextStamper, ImageStamper, HTMLStamper ve BarcodeStamper ile birleştirin. Başlıklar, altbilgiler, filigranlar ve tanımlama kodları içeren karmaşık belge düzenleri oluşturun.
Damga Konumunu Nasıl Kontrol Ederim?
Damga yerleşimini, üç yatay sütun ve üç dikey sıradan oluşan 3x3 bir ızgara tanımlayarak ayarlayın. Yatay hizalamayı seçin: sol, orta, sağ. Dikey hizalamayı seçin: üst, orta, alt. Kesin konumlama için yatay ve dikey ofsetleri ayarlayın. Görsel temsili için aşağıdaki görüntüye bakın.
Ana Konumlandırma Özellikleri Nelerdir?
HorizontalAlignment: Sayfaya göre yatay hizalama. Varsayılan:HorizontalAlignment.Center.VerticalAlignment: Sayfaya göre dikey hizalama. Varsayılan:VerticalAlignment.Middle.HorizontalOffset: Yatay kayma. Varsayılan: 0, birim:MeasurementUnit.Percentage. Pozitif değerler sağa, negatif değerler sola kaydırır.VerticalOffset: Dikey kayma. Varsayılan: 0, birim:MeasurementUnit.Percentage. Pozitif değerler aşağıya, negatif değerler yukarıya kaydırır.
Kesin Ofsetleri Nasıl Ayarlarım?
HorizontalOffset ve VerticalOffset sınıfını Length ile belirtin. Varsayılan ölçüm birimi yüzde. Mevcut birimler inç, milimetre, santimetre, piksel ve noktalar içerir. Bu, PDF belgelerinde özel kenar boşluklarını ayarlamak gibi kesin konumlama sağlar.
Kod
: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)
}
HTML İçeriği Nasıl Damgalarım?
Metin ve resimleri mühürlemek için HtmlStamper sınıfını kullanın. HtmlStamper, HTML tasarımlarını CSS stili ile işler, ardından bunları PDF belgelerine mühürler. HtmlBaseUrl özelliği, HTML dizi varlıkları için CSS ve resim dosyaları gibi temel URL'yi belirtir. Bu, HTML'yi PDF'ye dönüştürmek ile aynı oluşturma motorunu kullanır.
Kod
: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")
Temel HTML Damgacı Özellikleri Nelerdir?
Html: PDF'nize mühürlenecek HTML parçası. JavaScript, CSS ve resimler için dış referanslarHtmlBaseUrl'ya göre görelidir.HtmlBaseUrl: Dış CSS, JavaScript ve resim dosya referansları için temel URL.CssMediaType: Media='screen' CSS stillerini etkinleştirir.AllowScreenCss=false'yi ayarlamak, mühürleri CSS media='print' kullanarak işler. Varsayılan:PdfCssMediaType.Screen.
Neden HTML Damgacı, Metin Damgacıdan Daha İyi?
HTMLStamper, karmaşık düzenler, birden fazla yazı tipi, renkler ve bir mühür içinde gömülü resimler için tam HTML ve CSS desteği sağlar. Zengin içerik filigranları veya başlıklar için idealdir. Tutarlı bir markalama sağlar ve duyarlı CSS tasarımları ile çalışır.
Barkodları Nasıl Damgalarım?
BarcodeStamper sınıfı, mevcut PDF belgelerine doğrudan barkod mühürler. QRCode, Code128 ve Code39 barkod türlerini destekler.
Kod
: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")
Barkodlar İçin Hangi Yapılandırma Seçenekleri Var?
Value: Barkodun dize değeri.BarcodeType: QRCode, Code128 ve Code39 destekleyen kodlama türü. Varsayılan: QRCode.Width: Piksel cinsinden işlenmiş barkod genişliği. Varsayılan: 250px.Height: Piksel cinsinden işlenmiş barkod yüksekliği. Varsayılan: 250px.
Her Barkod Türünü Ne Zaman Kullanmalıyım?
QRCode, URL'ler ve büyük veri kümeleri (4.296 karaktere kadar) için uygundur. Code128, yüksek yoğunluk gereksinimleri olan alfasayısal veriler için uygundur. Code39, basit sayısal veya büyük harf kombinasyonları için çalışır. Barkod türlerini seçerken tarama ekipman uyumluluğunu dikkate alın.
Hangi Ek Damga Seçenekleri Var?
Bu özellikler, damganın görünümü ve davranışı üzerinde özel filigranlar oluşturmak gibi ince kontrol sağlar.
Damga Görünümünü Nasıl Kontrol Ederim?
Opacity: Şeffaflığı kontrol eder. 0 görünmez, 100 opaktır.Rotation: Mührü saat yönünde döndürüyor, 0 ila 360 derece.MaxWidth: Çıktı mührünün maksimum genişliği.MaxHeight: Çıktı mührünün maksimum yüksekliği.MinWidth: Çıktı mührünün minimum genişliği.MinHeight: Çıktı mührünün minimum yüksekliği.Hyperlink: Mühürlenen elemanlara tıklanabilir bağlantı ekler. Not: HTML bağlantıları (a etiketleri) damgalama ile korunmaz.Scale: Mühürlere yüzde ölçek uygular. Varsayılan: 100 (etki yoktur).IsStampBehindContent: Mührü içeriğin arkasına yerleştirir. Damga, içerik opak ise görünmez olabilir.WaitFor: Olayları veya zamanı bekler. Bkz. PDF oluşturmayı geciktirmek için WaitFor kullanım.Timeout: Saniye cinsinden oluşturma zaman aşımı. Varsayılan: 60.
En Yaygın Kullanılan Özellikler Hangileridir?
Opacity ve IsStampBehindContent, filigranlar oluşturur. Scale ve Rotation, görsel konum ve boyutlandırmayı ayarlar. Örnek:
// 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
}
Özet
IronPDF'in damgalama işlevi mevcut PDF belgelerine metin, görüntü, HTML içeriği ve barkodlar ekler. Filigranlar, başlıklar, alt bilgiler ve anotasyonlarla profesyonel belgeler oluşturmak amacıyla kapsamlı özelleştirme seçenekleriyle dört özel damga sınıfı. Çeşitli ölçüm birimleri ve hizalama seçenekleri ile konumlandırma sistemi pikselli mükemmel yerleştirmeyi sağlar. Basit metin damgaları veya CSS ile stilize edilmiş karmaşık HTML düzenlerini kullanın. IronPDF'in damgalama API'si, kurumsal sınıf PDF manipülasyonu için esneklik ve kontrol sunar.
Sıkça Sorulan Sorular
PDF belgelerime C#'ta metin filigranı nasıl eklerim?
IronPDF'un TextStamper sınıfını kullanarak metin filigranları ekleyin. Bir TextStamper nesnesi oluşturun, Metin, Yazı Tipi Boyutu ve Opaklık gibi özellikleri ayarlayın, ardından ApplyStamp yöntemini kullanın. Filigranları dikey ve yatay hizalama özelliklerini kullanarak hassas yerleştirme ile konumlandırabilirsiniz.
Mevcut PDF dosyalarına damga olarak resim ekleyebilir miyim?
Evet, IronPDF Pdf’lere resim eklemek için ImageStamper sınıfını sağlar. Bir ImageStamper nesnesi oluşturun, görsel dosyasını belirtin ve ApplyStamp yöntemini kullanın. Konumlandırmayı kontrol edebilir ve hangi sayfaların damgalanacağını sıfır tabanlı sayfa indekslemesi kullanarak belirtebilirsiniz.
PDF'lere hangi tür içerikler damgalanabilir?
IronPDF dört tür damga destekler: Metin anotasyonları ve filigranlar için TextStamper, görüntüler için ImageStamper, tam CSS stiline sahip HTML içeriği için HTMLStamper ve barkodlar için BarcodeStamper. Her damgalayıcı sınıf, hassas konumlandırma kontrolü sunar.
Çok satırlı metin damgalarını nasıl oluştururum?
Çok satırlı damgalar oluşturmak için TextStamper'ın Text özelliği içinde
etiketini kullanın. Örneğin, ‘satır 1
satır 2', adres damgaları veya çok satırlı filigranlar oluşturmak için ideal olan iki ayrı satırda metin gösterir.
PDF'lere metin damgalarken özel yazı tipleri kullanabilir miyim?
Evet, IronPDF'ün TextStamper'ı hem sistem yazı tiplerini hem de Google Fonts’u destekler. Google Fonts kullanmak için Use_google_Font özelliğini true olarak ayarlayın veya herhangi bir yüklü sistem yazı tipini FontFamily özelliğini kullanarak belirterek tam bir tipografi denetimi sağlarsınız.
Yalnızca belirli sayfalara damga eklemek mümkün mü?
Kesinlikle. ApplyStamp yöntemi, belirli sayfalara damga basmanızı sağlayan bir sayfa indeks parametresi kabul eder. IronPDF, sıfır tabanlı indeksleme kullanır, bu nedenle sayfa 1 için indeks 0’dır. Ayrıca birden fazla sayfaya damga eklemek için ApplyMultipleStamps kullanabilirsiniz.

