Metadati un Utilītprogrammas

Metadati un utilītprogrammas

Aspose.PDF FOSS for .NET ietver utilītklases metadatu piekļuvei, koordinātu ģeometrijai, attēlu kolekcijām un lapas līmeņa artefaktiem. Šie būvbloki atbalsta augstāka līmeņa operācijas visā bibliotēkā.

XMP metadati

Metadata dokumentā nodrošina piekļuvi XMP metadatu straumei. Lasiet un rakstiet standarta vai pielāgotas XMP īpašības.

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ātu ģeometrija

Rectangle un Matrix tiek izmantoti visā API pozicionēšanai un transformācijai.

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

Lapas kolekcijas operācijas

PageCollection atbalsta indeksēšanu, iterāciju un apmeklētāja modeļa pieņemšanu.

using var doc = Document.Open(pdfBytes);

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

Attēlu kolekcijas

XImageCollection pārvalda lapas resursos iekļautos attēlus. XImage nodrošina metodes attēlu īpašību pārbaudīšanai.

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

Artefakti

Artifact apzīmē ne‑satura elementus, piemēram, ūdenszīmes, galvenes un
kājenes. Izmantojiet artefaktus lapas numurēšanai un dekoratīviem elementiem.

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

Padomi un labākā prakse

• XMP metadatu atslēgas seko Dublin Core un XMP specifikācijām — izmantojiet standarta vārdtelpu prefiksus.
• Rectangle koordinātas ir PDF lietotāja telpas vienībās (1/72 collas), ar sākumu apakšējā kreisajā stūrī.
• Izmantojiet Matrix afinām transformācijām: translāciju, rotāciju, mērogošanu un slīpēšanu.
• XmpValue atbalsta virknes, veselos skaitļus, dubultus, datumus un masīvu tipus.
• Artefakti ir strukturāli elementi — tie neparādās pieejamības koka pārlūkojumos.

Bieži sastopamās problēmas

Biežāk uzdotie jautājumi

Kā es varu nolasīt dokumenta nosaukumu no metadatiem?

Piekļūstiet doc.Metadata["dc:title"] Dublin Core virsraksta īpašībai.

Vai es varu pievienot ūdenszīmes artefaktu?

Jā. Izveidojiet Artifact ar tipu Watermark un pievienojiet to lapai.

Kādu koordinātu sistēmu izmanto Rectangle?

PDF lietotāja telpa: izcelsme apakšējā kreisajā stūrī, vienības 1/72 collas. Standarta ASV vēstules lapa ir 612 × 792 vienības.

API atsauces kopsavilkums

Skatīt arī

• Aspose.PDF for .NET Enterprise produkts