Metaadatok és segédprogramok

Metaadatok és segédprogramok

Aspose.PDF FOSS for .NET tartalmaz segédosztályokat a metaadatok eléréséhez, koordináta geometria, képkollekciók és oldalszintű műtárgyak kezeléséhez. Ezek az építőelemek támogatják a magasabb szintű műveleteket a könyvtárban.

XMP metaadatok

Metadata egy dokumentumban hozzáférést biztosít az XMP metaadatfolyamhoz. Olvassa és írja a szabványos vagy egyéni XMP tulajdonságokat.

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

Koordináta geometria

Rectangle és Matrix az API-ban a pozicionáláshoz és átalakításhoz használatosak.

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

Oldalgyűjtemény műveletei

PageCollection támogatja az indexelést, az iterációt és a látogató-minta elfogadását.

using var doc = Document.Open(pdfBytes);

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

Képkollekciók

XImageCollection kezeli a lap erőforrásaiban beágyazott képeket. XImage módszereket biztosít a képtulajdonságok vizsgálatához.

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

Műtárgyak

Artifact nem tartalmi elemeket jelöl, mint például vízjelek, fejlécek és
láblécek. Használjon műtárgyakat az oldalszámozáshoz és díszítő elemekhez.

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

Tippek és bevált gyakorlatok

• Az XMP metaadat kulcsok a Dublin Core és az XMP specifikációkat követik — használjon szabványos névtér előtagokat.
• Rectangle koordináták a PDF felhasználói tér egységeiben (1/72 hüvelyk), a kiindulási pont bal alsó sarokban van.
• Használja Matrix-t affín transzformációkhoz: eltolás, forgatás, méretezés és nyírás.
• XmpValue támogatja a string, integer, double, date és array típusokat.
• A műtárgyak strukturális elemek — nem jelennek meg a hozzáférhetőségi fa bejárásaiban.

Gyakori problémák

GYIK

Hogyan olvashatom ki a dokumentum címét a metaadatokból?

Hozzáférés doc.Metadata["dc:title"] a Dublin Core cím tulajdonsághoz.

Hozzáadhatok egy vízjel artefaktumot?

Igen. Hozzon létre egy Artifact-t a Watermark típussal, és adja hozzá az oldalhoz.

Milyen koordináta‑rendszert használ a Rectangle?

PDF felhasználói tér: origó a bal alsó sarokban, egységek 1/72 hüvelyk. Egy szabványos
US Letter oldal 612 x 792 egység.

API Referencia Összefoglaló

Lásd még

• Aspose.PDF for .NET Enterprise termék