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.
  • Rectangle koordinatları PDF kullanıcı alanı birimlerinde (1/72 inç) olup, orijin sol‑alt köşededir.
  • Affine dönüşümler için Matrix kullanın: çevirme, döndürme, ölçekleme ve kaydırma.
  • XmpValue string, integer, double, date ve array tiplerini destekler.
  • Artifacts yapısal öğelerdir — erişilebilirlik ağacı geçişlerinde görünmezler.

Yaygın Sorunlar

IssueCauseFix
Meta veri anahtarı bulunamadıAnahtar farklı bir ad alanı öneki kullanıyorDoğru önek bulmak için önce tüm anahtarları listeleyin
Dikdörtgen koordinatları ters gibi görünüyorPDF kökeni sol alt köşe, üst köşe değilY 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 / MethodDescription
MetadataBelgedeki XMP meta veri sözlüğü
XmpValueXMP özellik değerleri için tiplenmiş sarmalayıcı
RectangleEksen hizalı sınırlayıcı kutu (llx, lly, urx, ury)
Rectangle.ContainsPointBir noktanın dikdörtgen içinde olup olmadığını test et
Matrix2B affine dönüşüm matrisi
Matrix.TranslateÇeviri matrisi oluştur
PageCollection1 tabanlı indeksleme ile sıralı sayfa koleksiyonu
XImageCollectionSayfadaki görüntü kaynakları
XImageRenk tipi algılamalı tek gömülü görüntü
Artifactİçerik dışı sayfa öğesi (filigran, üst bilgi, alt bilgi)
Artifact.SetPageNumberReplacementStringSayfa numarası artefaktları için şablon

Ayrıca Bakınız

 Türkçe