Metadata dan Utiliti

Metadata dan Utiliti

Aspose.PDF FOSS for .NET termasuk kelas utiliti untuk akses metadata, geometri koordinat, koleksi imej, dan artifak peringkat halaman. Ini blok binaan menyokong operasi peringkat lebih tinggi di seluruh perpustakaan.

metadata XMP

Metadata pada dokumen menyediakan akses kepada aliran metadata XMP. Baca dan tulis sifat XMP standard atau tersuai.

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

Geometri koordinat

Rectangle dan Matrix digunakan di seluruh API untuk penempatan dan transformasi.

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

Operasi koleksi Halaman

PageCollection menyokong pengindeksan, iterasi, dan penerimaan corak pelawat.

using var doc = Document.Open(pdfBytes);

for (int i = 1; i <= doc.Pages.Count; i++)
{
    var page = doc.Pages[i];
}

Koleksi imej

XImageCollection menguruskan imej yang disematkan dalam sumber halaman. XImage menyediakan kaedah untuk memeriksa sifat imej.

var images = doc.Pages[1].Resources.Images;
foreach (var img in images)
{
    Console.WriteLine($"Color type: {img.GetColorType()}");
}

Artifak

Artifact mewakili elemen bukan kandungan seperti watermark, pengepala, dan pengaki. Gunakan artifak untuk penomboran halaman dan elemen hiasan.

var artifact = new Artifact(ArtifactType.Watermark);
artifact.SetPageNumberReplacementString("Page {0}");

Petua dan Amalan Terbaik

• Kunci metadata XMP mengikuti spesifikasi Dublin Core dan XMP — gunakan awalan ruang nama standard.
• Koordinat Rectangle berada dalam unit ruang pengguna PDF (1/72 inci), dengan asal di kiri-bawah.
• Gunakan Matrix untuk transformasi afinn: translasi, putaran, penskalaan, dan shearing.
• XmpValue menyokong jenis string, integer, double, date, dan array.
• Artifak adalah elemen struktur — ia tidak muncul dalam penjelajahan pokok kebolehcapaian.

Isu Umum

Soalan Lazim

Bagaimana saya membaca tajuk dokumen daripada metadata?

Akses doc.Metadata["dc:title"] untuk sifat tajuk Dublin Core.

Bolehkah saya menambah artifak watermark?

Ya. Buat Artifact dengan jenis Watermark dan tambahkan ke halaman.

Apakah sistem koordinat yang digunakan oleh Rectangle?

PDF user-space: asal di bahagian bawah kiri, unit 1/72 inci. Halaman US Letter standard
berukuran 612 x 792 unit.

Ringkasan Rujukan API

Lihat Juga

• Aspose.PDF untuk .NET Produk Enterprise