PDFsharp vs QuestPDF (C# PDF Kütüphanesi Derinlemesine Karşılaştırma)
Bir anotasyonu sayfanın üzerine şeffaf bir tabaka olarak hayal edin: yapışkan not yorumu üstte dururken, alttaki belge dokunulmaz kalır. IronPDF, bir PdfDocument üzerindeki Annotations koleksiyonu aracılığıyla bu katmanı yönetir, küçük simgeler olarak görünen ve tıklandığında tam yorumu ortaya çıkaran notları ekler, düzenler ve kaldırır. Katman içerikten ayrı olduğu için, bir notu düzenlemek veya kaldırmak, diğer tüm belge özelliklerini bozulmadan bırakır, böylece anotasyonlar orijinalin temiz kalması gereken yerlere uyabilir.
Belge inceleme ve işaretleme
Anotasyonlara en yaygın ulaşma. Bir inceleme aracı, belirli noktalara geri bildirim iliştirir ve belgenin kaynak içeriği değiştirilmeden bir sonraki kişi için bir yorumlu kopyayı kaydeder:
using IronPdf;
using IronPdf.Annotations;
var pdf = PdfDocument.FromFile("draft.pdf");
pdf.Annotations.Add(new TextAnnotation(0)
{
Title = "Reviewer",
Contents = "Clarify this clause.",
X = 50,
Y = 700
});
pdf.SaveAs("draft-reviewed.pdf");
using IronPdf;
using IronPdf.Annotations;
var pdf = PdfDocument.FromFile("draft.pdf");
pdf.Annotations.Add(new TextAnnotation(0)
{
Title = "Reviewer",
Contents = "Clarify this clause.",
X = 50,
Y = 700
});
pdf.SaveAs("draft-reviewed.pdf");
Imports IronPdf
Imports IronPdf.Annotations
Dim pdf = PdfDocument.FromFile("draft.pdf")
pdf.Annotations.Add(New TextAnnotation(0) With {
.Title = "Reviewer",
.Contents = "Clarify this clause.",
.X = 50,
.Y = 700
})
pdf.SaveAs("draft-reviewed.pdf")
Orijinali Dokunmadan Sözleşme İşbirliği
Anotasyon katmanı sözleşme gövdesinden ayrı kaldığı için, hukuk ekipleri bağlayıcı metni hiç değiştirmeyen notlar bırakabilir. Denetim veya imza için belgenin temiz kalması gereken her yerde bu ayrım önemlidir.
Teknik Belgelerde Kalite Koruması
Otomatik bir kontrol, bir sorun (eksik bir şekil, belirtim dışı bir değer) algıladığında yerleştirilmiş bir not bırakabilir, bir insana tıklanabilir sorunlar haritası verir, ayrı bir rapor değil.
Revizyon Döngüsü Üzerinde Düzenleme
Mevcut anotasyonlar, geri bildirim değiştikçe veya notlar yeniden konumlandırılması gerektiğinde alınabilir ve güncellenebilir. Bu, üst bir gözden geçirenin notları imzadan önce değiştirdiği onay zincirlerini destekler:
using System.Linq;
var pdf = PdfDocument.FromFile("draft-reviewed.pdf");
var note = (TextAnnotation)pdf.Annotations.First();
note.Contents = "Resolved in v2.";
note.X = 150;
pdf.SaveAs("draft-updated.pdf");
using System.Linq;
var pdf = PdfDocument.FromFile("draft-reviewed.pdf");
var note = (TextAnnotation)pdf.Annotations.First();
note.Contents = "Resolved in v2.";
note.X = 150;
pdf.SaveAs("draft-updated.pdf");
Imports System.Linq
Dim pdf = PdfDocument.FromFile("draft-reviewed.pdf")
Dim note = CType(pdf.Annotations.First(), TextAnnotation)
note.Contents = "Resolved in v2."
note.X = 150
pdf.SaveAs("draft-updated.pdf")
Dağıtımdan Önce Temizlik
Kaldırma, kendi kullanım durumudur. Bir belge gönderilmeden önce çift iç veya eski yorumları çıkarın, böylece geri bildirim asla harici bir kitleye sızmaz. Biri için RemoveAt kullanın, bir sayfa için RemoveAllAnnotationsForPage veya tüm belge için Clear kullanın. Bu, hijyen veya PDF/A dışa aktarma ve sonlandırma adımı ile doğal olarak eşleşir.
Sizi Yakalayacak İki Şey
PDF koordinatları, UI çerçevelerinin çoğunun kullandığı üst-sol köşe değil, alt-sol köşeden başlar ve noktalarda (1/72 inç) ölçülür; US Letter 612 x 792, A4 595 x 842. Bunu hesaba katmadan, anotasyonlar yanlış yerde biter.
Anotasyon koleksiyonu her kaldırılma işleminden sonra tekrar indekslenir. Çok sayıda silmek için geriye doğru çalışın ya da onları önce toplayın ve ardından ters sırada kaldırın, aksi takdirde yanlışları silersiniz.
Ne Oldukları ve Ne Olmadıkları
Dokümante edilmiş tür, başlık, içerik, konum, sayfa, konu, simge ve açık durumu için özelliklere sahip TextAnnotation, yapışkan nottur. Vurgulama, mürekkep veya damga işaretleme değildir. Yorumlama ve inceleme ile eşleştirin, iyi yaptığı işi, görsel işaretleme ile yaptığı iddia edilmeyen iş için değil.
Sıkça Sorulan Sorular
IronPDF ile C# dilinde bir PDF'ye metin açıklaması nasıl eklerim?
Bir TextAnnotation nesnesi ile PdfDocument üzerindeki Annotations.Add metodunu kullanın. Sayfa dizinini, X/Y konumunu (PDF noktalarında sol alt köşeden itibaren), başlığı ve içerik özelliklerini ayarlayın.
Bir açıklama eklemek veya kaldırmak, altta yatan PDF içeriğini değiştirir mi?
Hayır. Açıklama katmanı belge içeriğinden ayrı durumdadır. Açıklamaları düzenlemek veya kaldırmak, belgenin diğer tüm özelliklerini, metinlerini ve görsellerini bozulmadan bırakır.
Dağıtımından önce bir PDF’den açıklamaları nasıl kaldırırım?
RemoveAt(index) ile tek bir açıklamayı silin, bir sayfayı temizlemek için RemoveAllAnnotationsForPage(pageIndex) kullanın veya belgedeki tüm açıklamaları kaldırmak için Annotations.Clear() işlemini uygulayın.
Neden açıklamalarım yanlış yerlerde görünüyor?
PDF koordinatları sol alt köşeden başlar, çoğu UI çerçevesinin kullandığı üst sol köşeden değil. Koordinatlar noktalarla (1/72 inç) ölçülür. ABD Letter 612 x 792 puandır; A4 595 x 842 puandır. X ve Y değerlerinizi buna göre ayarlayın.
Mevcut bir açıklamanın metni veya konumu güncellenebilir mi?
Evet. Açıklamayı Annotations koleksiyonundan alın, TextAnnotation olarak atayın ve belgeyi kaydetmeden önce Contents, X, Y veya diğer özelliklerini güncelleyin.

