Meta Veri ve Araçlar
Meta Veriler ve Araçlar
Aspose.PDF FOSS for .NET metadata erişimi, koordinat geometrisi, görüntü koleksiyonları ve sayfa düzeyinde yapılar için yardımcı sınıflar içerir. Bu yapı taşları, kütüphane genelinde daha yüksek seviyeli işlemleri destekler.
XMP meta verileri
Metadata bir belgede XMP meta veri akışına erişim sağlar. Standart veya özel XMP özelliklerini okuyun ve
yazın.
using var doc = Document.Open(pdfBytes);
// Read existing metadata
foreach (var entry in doc.Metadata)
{
Console.WriteLine($"{entry.Key}: {entry.Value}");
}
// Set a custom property
doc.Metadata.Add("xmp:CustomProp", new XmpValue("custom value"));
doc.Save("with-metadata.pdf");Koordinat geometri
Rectangle ve Matrix API genelinde konumlandırma ve dönüşüm için kullanılır.
var rect = new Rectangle(72, 700, 300, 720);
bool inside = rect.ContainsPoint(150, 710);
// Transformation matrix (translate by 100, 200)
var matrix = new Matrix(1, 0, 0, 1, 100, 200);Sayfa koleksiyonu işlemleri
PageCollection indeksleme, yineleme ve ziyaretçi deseni kabulünü destekler.
using var doc = Document.Open(pdfBytes);
for (int i = 1; i <= doc.Pages.Count; i++)
{
var page = doc.Pages[i];
}Görüntü koleksiyonları
XImageCollection sayfanın kaynaklarına gömülü görüntüleri yönetir. XImage görüntü özelliklerini incelemek için yöntemler sağlar.
var images = doc.Pages[1].Resources.Images;
foreach (var img in images)
{
Console.WriteLine($"Color type: {img.GetColorType()}");
}Artefaktlar
Artifact, filigranlar, başlıklar ve altbilgiler gibi içerik dışı öğeleri temsil eder. Sayfa numaralandırma ve süsleme öğeleri için artifacts kullanın.
var artifact = new Artifact(ArtifactType.Watermark);
artifact.SetPageNumberReplacementString("Page {0}");İpuçları ve En İyi Uygulamalar
- XMP meta veri anahtarları Dublin Core ve XMP spesifikasyonlarını izler — standart ad alanı öneklerini kullanın.
Rectanglekoordinatları PDF kullanıcı alanı birimlerinde (1/72 inç) olup, orijin sol‑alt köşededir.- Affine dönüşümler için
Matrixkullanın: çevirme, döndürme, ölçekleme ve kaydırma. XmpValuestring, integer, double, date ve array tiplerini destekler.- Artifacts yapısal öğelerdir — erişilebilirlik ağacı geçişlerinde görünmezler.
Yaygın Sorunlar
| Issue | Cause | Fix |
|---|---|---|
| Meta veri anahtarı bulunamadı | Anahtar farklı bir ad alanı öneki kullanıyor | Doğru önek bulmak için önce tüm anahtarları listeleyin |
| Dikdörtgen koordinatları ters gibi görünüyor | PDF kökeni sol alt köşe, üst köşe değil | Y koordinatlarını buna göre ayarlayın |
| Görüntü koleksiyonu boş | Görüntüler form XObjects içinde, doğrudan sayfa kaynaklarında değil | İç içe görüntü kaynakları için XFormCollection‘yi kontrol edin |
SSS
Metadatalardan belge başlığını nasıl okurum?
Dublin Core başlık özelliği için doc.Metadata["dc:title"] erişin.
Bir filigran öğesi ekleyebilir miyim?
Evet. Artifact‘yi Watermark türüyle oluşturun ve sayfaya ekleyin.
Rectangle hangi koordinat sistemini kullanır?
PDF kullanıcı alanı: köken alt‑sol köşede, birim 1/72 inç. Standart bir US Letter sayfası 612 × 792 birimdir.
API Referans Özeti
| Class / Method | Description |
|---|---|
Metadata | Belgedeki XMP meta veri sözlüğü |
XmpValue | XMP özellik değerleri için tiplenmiş sarmalayıcı |
Rectangle | Eksen hizalı sınırlayıcı kutu (llx, lly, urx, ury) |
Rectangle.ContainsPoint | Bir noktanın dikdörtgen içinde olup olmadığını test et |
Matrix | 2B affine dönüşüm matrisi |
Matrix.Translate | Çeviri matrisi oluştur |
PageCollection | 1 tabanlı indeksleme ile sıralı sayfa koleksiyonu |
XImageCollection | Sayfadaki görüntü kaynakları |
XImage | Renk tipi algılamalı tek gömülü görüntü |
Artifact | İçerik dışı sayfa öğesi (filigran, üst bilgi, alt bilgi) |
Artifact.SetPageNumberReplacementString | Sayfa numarası artefaktları için şablon |