البيانات الوصفية والأدوات

البيانات الوصفية والأدوات

يتضمن 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 يدعم الأنواع سلسلة، عدد صحيح، مزدوج، تاريخ، ومصفوفة.
• القطع الأثرية هي عناصر هيكلية — لا تظهر في عمليات عبور شجرة إمكانية الوصول.

مشكلات شائعة

الأسئلة المتكررة

كيف يمكنني قراءة عنوان المستند من البيانات الوصفية؟

الوصول إلى doc.Metadata["dc:title"] لخاصية العنوان في Dublin Core.

هل يمكنني إضافة عنصر علامة مائية؟

نعم. إنشاء Artifact من النوع Watermark وإضافته إلى الصفحة.

ما نظام الإحداثيات الذي يستخدمه Rectangle؟

مساحة المستخدم في PDF: الأصل في الزاوية السفلية اليسرى، الوحدات هي 1/72 بوصة. صفحة US Letter القياسية هي 612 × 792 وحدة.

ملخص مرجع API

انظر أيضًا

• Aspose.PDF for .NET المنتج المؤسسي