محول XPS لبرنامج .NET

مقدمة لمحول XPS لبرنامج .NET

محول XPS لبرنامج .NET هو مكتبة قوية تسمح للمطورين بتحويل ملفات XPS (مواصفات ورق XML) إلى صيغ صور مختلفة، بما في ذلك PNG و JPEG و TIFF وغيرها. هذا الدليل سوف يقودك خلال الميزات المتاحة للمكتبة وسوف توفر أمثلة كود لمساعدتك على البدء.

تحويل XPS إلى PDF

تحويل ملف XPS هو عملية بسيطة تتضمن تحميل ملف XPS وتحديد صيغة الإخراج. مثال الكود التالي يظهر كيفية تحويل ملف XPS إلى وثيقة PDF:

XpsConverter converter = new XpsConverter();
XpsConverterToPdfOptions opt = new XpsConverterToPdfOptions();
opt.AddDataSource(new FileDataSource("input.xps"));
opt.AddSaveDataSource(new FileDataSource("output.pdf"));
converter.Process(opt);

في هذا المثال، نحمل ملف XPS من تدفق وننشئ كائن جديد من XpsConverter. ثم نحدد صيغة الإخراج على أنها PDF ونهمل الوثيقة إلى تدفق جديد.

تحويل XPS إلى صور

تحويل ملف XPS هو عملية بسيطة تتضمن تحميل ملف XPS وتحديد صيغة الإخراج. مثال الكود التالي يظهر كيفية تحويل ملف XPS إلى صورة PNG:

XpsConverter converter = new XpsConverter();
PsConverterToImageOptions opt = new PsConverterToImageOptions();
opt.AddDataSource(new FileDataSource("input.xps"));
opt.AddSaveDataSource(new FileDataSource("output.png"));
converter.Process(opt);

في هذا المثال، نحمل ملف XPS من تدفق وننشئ كائن جديد من XpsConverter. ثم نحدد صيغة الإخراج على أنها PNG ونهمل الوثيقة إلى تدفق جديد.

الصيغ المدعومة

محول XPS لبرنامج .NET يدعم مجموعة واسعة من الصيغ، بما في ذلك:

• PNG (صور الشبكة المحمولة)
• JPEG (مجموعة الخبراء الفوتوغرافية المشتركة)
• TIFF (صيغة ملف الصور المُوسومة)
• BMP (صورة Bitmap)
• GIF (صيغة تبادل الرسومات)

التعامل مع الأخطاء والاستثناءات

محول XPS لبرنامج .NET يطرح استثناءات إذا حدث خطأ أثناء عملية التحويل. يمكنك التعامل مع هذه الاستثناءات باستخدام كتل Try-Catch.

try
{
    XpsConverter converter = new XpsConverter();
    XpsConverterToPdfOptions opt = new XpsConverterToPdfOptions();
    opt.AddDataSource(new FileDataSource("input.xps"));
    opt.AddSaveDataSource(new FileDataSource("output.pdf"));
    converter.Process(opt);
}
catch (NotSupportedException ex)
{
    Console.WriteLine($"خطأ في تحويل الملف: {ex.Message}");
}

ملاحظة أن فئة NotSupportedException توفر معلومات إضافية حول الخطأ، مثل رمز الخطأ ورسالته.