מטא-נתונים וכלים

מטא-נתונים וכלים

Aspose.PDF FOSS for .NET כולל מחלקות שירות לגישה למטא‑נתונים, גאומטריה קואורדינטית, אוספי תמונות, ופריטי רמת דף. אלה בלוקים תומכים בפעולות ברמה גבוהה לאורך כל הספרייה.

מטא-נתונים של XMP

Metadata ב‑מסמך מספק גישה לזרם המטא‑נתונים XMP. קריאה וכתיבה של מאפייני XMP סטנדרטיים או מותאמים אישית.

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

גיאומטריה קרטזית

Rectangle ו-Matrix משמשים בכל ה-API למיקום ולהמרה.

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

פעולות על אוסף דפים

PageCollection תומך באינדקסציה, איטרציה וקבלת תבנית מבקר.

using var doc = Document.Open(pdfBytes);

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

אוספי תמונות

XImageCollection מנהל תמונות משובצות במשאבי העמוד. XImage מספק שיטות לבדיקת מאפייני תמונה.

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

ארטיפקטים

Artifact מייצג אלמנטים שאינם תוכן כגון סימני מים, כותרות, ו תחתיות. השתמש בפריטים למספרי עמודים ולאלמנטים דקורטיביים.

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

טיפים ושיטות מומלצות

• מפתחות המטא‑נתונים של XMP פועלים לפי המפרטים של Dublin Core ו‑XMP — השתמשו בקידומות מרחב שם סטנדרטיות.
• Rectangle הקואורדינטות הן ביחידות מרחב המשתמש של PDF (1/72 אינץ’), עם מקור בפינה השמאלית התחתונה.
• השתמשו בMatrix עבור טרנספורמציות אפיניות: תרגום, סיבוב, שינוי קנה מידה, ועיקום.
• XmpValue תומך בסוגי string, integer, double, date ו‑array.
• Artifacts הם אלמנטים מבניים — הם אינם מופיעים במעברי עץ הנגישות.

בעיות נפוצות

שאלות נפוצות

איך אני קורא את כותרת המסמך ממטא‑דאטה?

גש doc.Metadata["dc:title"] לתכונת הכותרת של Dublin Core.

האם אני יכול להוסיף פריט סימן מים?

כן. צור Artifact עם סוג Watermark והוסף אותו לדף.

איזו מערכת קואורדינטות משתמשת Rectangle?

PDF user-space: המקור בפינה השמאלית התחתונה, יחידות של 1/72 אינץ’. דף סטנדרטי דף US Letter הוא 612 x 792 יחידות.

API סיכום הפניות

ראה גם

• Aspose.PDF for .NET מוצר Enterprise