Metatiedot ja työkalut

Metatiedot ja työkalut

Aspose.PDF FOSS for .NET sisältää apuluokkia metatietojen käytölle, koordinaattigeometriaa, kuvakokoelmia ja sivutasoisia artefakteja. Nämä rakennuspalikat tukevat korkeamman tason toimintoja koko kirjastossa.

XMP-metadata

Metadata asiakirjassa tarjoaa pääsyn XMP‑metatietovirtaan. Lue ja kirjoita vakio‑ tai mukautettuja XMP‑ominaisuuksia.

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

Koordinaatistogeometria

Rectangle ja Matrix käytetään API:ssa laajasti sijoitteluun ja muunnokseen.

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

Sivukokoelman toiminnot

PageCollection tukee indeksointia, iteraatiota ja vierailijamallin hyväksyntää.

using var doc = Document.Open(pdfBytes);

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

Kuvakokoelmat

XImageCollection hallinnoi sivun resurssiin upotettuja kuvia. XImage tarjoaa menetelmiä kuvan ominaisuuksien tarkasteluun.

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

Artefaktit

Artifact edustaa sisällöstä poikkeavia elementtejä, kuten vesileimoja, ylätunnisteita ja alatunnisteita. Käytä artefakteja sivunumerointiin ja koristeellisiin elementteihin.

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

Vinkkejä ja parhaita käytäntöjä

• XMP‑metatietojen avaimet noudattavat Dublin Core‑ ja XMP‑spesifikaatioita — käytä standardin nimialueiden etuliitteitä.
• Rectangle koordinaatit ovat PDF:n käyttäjätilan yksiköissä (1/72 tuumaa), alkuperä alhaalla vasemmalla.
• Käytä Matrix affiinimuunnoksiin: siirto, kierto, skaalaus ja vinouma.
• XmpValue tukee merkkijono‑, kokonaisluku‑, double‑, päivämäärä‑ ja taulukko‑tyyppejä.
• Artifaktit ovat rakenteellisia elementtejä — ne eivät näy saavutettavuuspuun läpikäynneissä.

Yleiset ongelmat

UKK

Kuinka luen asiakirjan otsikon metatiedoista?

Käytä doc.Metadata["dc:title"] Dublin Core -otsikkomääritteelle.

Voinko lisätä vesileiman artefaktin?

Kyllä. Luo Artifact, jonka tyyppi on Watermark, ja lisää se sivulle.

Mitä koordinaatistojärjestelmää Rectangle käyttää?

PDF user-space: alku alhaalla vasemmalla, yksiköt 1/72 tuumaa. Standardi US Letter -sivu on 612 x 792 yksikköä.

API-viitteiden yhteenveto

Katso myös

• Aspose.PDF for .NET Enterprise Product