Class PdfConverter

معلومات

يمثل مكوّن Documentize.PdfConverter. يُستخدم لتحويل مستندات PDF إلى صيغ أخرى مثل DOCX/DOC، XLSX/XLS/CSV/XLSM/ODS، HTML، JPEG، PNG، TIFF، PDF/A. كما يتيح لك إجراء التحقق من PDF/A وتحويل HTML إلى PDF.

يمثل مكوّن Documentize.PdfConverter. يُستخدم لتحويل مستندات PDF إلى صيغ أخرى مثل DOCX/DOC، XLSX/XLS/CSV/XLSM/ODS، HTML، JPEG، PNG، TIFF، PDF/A. كما يتيح لك إجراء التحقق من PDF/A وتحويل HTML إلى PDF.

public static class PdfConverter

الوراثة

object ← PdfConverter

الأعضاء الموروثة

الطرق

Convert(PdfToDocOptions)

يقوم بتحويل مستند PDF إلى صيغ DOC/DOCX.

public static ResultContainer Convert(PdfToDocOptions options)

المعلمات

  • options PdfToDocOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة Doc.

// إنشاء كائن PdfToDocOptions لتحديد التعليمات
var options = new PdfToDocOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileData("path_to_result_file.doc"));
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة Doc مع ضبط الوضع.

// إنشاء كائن PdfToDocOptions لتحديد التعليمات
var options = new PdfToDocOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileData("path_to_result_file.doc"));
// ضبط الوضع
options.Mode = DocConversionMode.Flow;
// تنفيذ العملية
PdfConverter.Convert(options);

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

Convert(PdfToXlsOptions)

يقوم بتحويل مستند PDF إلى صيغ XLSX/XLS/CSV/XLSM/ODS.

public static ResultContainer Convert(PdfToXlsOptions options)

المعلمات

  • options PdfToXlsOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية تحويل PDF إلى مستند XLSX.

// إنشاء كائن PdfToXlsOptions لتحديد التعليمات
var options = new PdfToXlsOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileData("path_to_result_xlsx_file.xlsx"));
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال كيفية تحويل PDF إلى مستند XLS.

// إنشاء كائن PdfToXlsOptions لتحديد التعليمات
var options = new PdfToXlsOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد صيغة XLS
options.Format = PdfToXlsOptions.ExcelFormat.XMLSpreadSheet2003;
options.InsertBlankColumnAtFirst = true;
options.MinimizeTheNumberOfWorksheets = true;
// تحديد مسار ملف الإخراج
options.AddOutput(new FileData("path_to_result_xlsx_file.xls"));
// تنفيذ العملية
PdfConverter.Convert(options);

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

Convert(PdfToHtmlOptions)

يقوم بتحويل مستند PDF إلى صيغة HTML.

public static ResultContainer Convert(PdfToHtmlOptions options)

المعلمات

  • options PdfToHtmlOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية تحويل PDF إلى مستند HTML.

// إنشاء كائن PdfToHtmlOptions لتحديد نوع البيانات كملف مع موارد مدمجة
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileData("path_to_output.html"));
// تنفيذ العملية
PdfConverter.Convert(options);

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

Convert(HtmlToPdfOptions)

يقوم بتحويل مستند HTML إلى صيغة PDF.

public static ResultContainer Convert(HtmlToPdfOptions options)

المعلمات

  • options HtmlToPdfOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية تحويل مستند HTML إلى PDF.

// إنشاء HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.html"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileData("path_to_output.pdf"));
// تنفيذ العملية
PdfConverter.Convert(options);

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

Convert(PdfToJpegOptions)

يقوم بتحويل مستند PDF إلى صيغة JPEG.

public static ResultContainer Convert(PdfToJpegOptions options)

المعلمات

  • options PdfToJpegOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة JPEG.

// إنشاء كائن PdfToJpegOptions لتحديد التعليمات
var options = new PdfToJpegOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryData("path_to_output_directory"));
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة JPEG مع إعدادات للصفحات، الدقة، الجودة.

// إنشاء كائن PdfToJpegOptions لتحديد التعليمات
var options = new PdfToJpegOptions();
// معالجة الصفحة الأولى فقط
options.PageList = [1];
// ضبط دقة الإخراج إلى 200 DPI
options.OutputResolution = 200;
// ضبط جودة الإخراج إلى 50
options.Quality = 50;
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryData("path_to_output_directory"));
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة JPEG إلى تدفقات.

// إنشاء كائن PdfToJpegOptions لتحديد التعليمات
var options = new PdfToJpegOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.pdf"));
// تنفيذ العملية
var results = PdfConverter.Convert(options);
// الحصول على نتائج التدفق
foreach (var result in results.ResultCollection)
{
    var streamResultPage1 = result.ToStream();
}

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

Convert(PdfToPngOptions)

يقوم بتحويل مستند PDF إلى صيغة PNG.

public static ResultContainer Convert(PdfToPngOptions options)

المعلمات

  • options PdfToPngOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة PNG.

// إنشاء كائن PdfToPngOptions لتحديد التعليمات
var options = new PdfToPngOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryData("path_to_output_directory"));
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال تحويل صفحة واحدة من مستند PDF إلى صيغة PNG.

// إنشاء كائن PdfToPngOptions لتحديد التعليمات
var options = new PdfToPngOptions()
// معالجة الصفحة الأولى فقط
options.PageList = [1];
// ضبط دقة الإخراج إلى 200 DPI
options.OutputResolution = 200;
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryData("path_to_output_directory"));
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة PNG إلى تدفقات.

// إنشاء كائن PdfToPngOptions لتحديد التعليمات
var options = new PdfToPngOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.pdf"));
// تنفيذ العملية
var results = PdfConverter.Convert(options);
// الحصول على نتائج التدفق
foreach (var result in results.ResultCollection)
{
    var streamResultPage1 = result.ToStream();
}

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

Convert(PdfToTiffOptions)

يقوم بتحويل مستند PDF إلى صيغة TIFF.

public static ResultContainer Convert(PdfToTiffOptions options)

المعلمات

  • options PdfToTiffOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة TIFF.

// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryData("path_to_output_directory"));
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة TIFF مع تخصيص الصفحات والدقة.

// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryData("path_to_output_directory"));
// تحديد الصفحات
options.PageList = [1, 3];
// ضبط دقة الصورة الناتجة
options.OutputResolution = 400;
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال تحويل مستند PDF إلى TIFF متعدد الصفحات.

// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryData("path_to_output_directory"));
// تمكين إخراج TIFF متعدد الصفحات
options.MultiPage = true;
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال تحويل مستند PDF إلى صيغة TIFF مع تخصيص الضغط وعمق اللون.

// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryData("path_to_output_directory"));
// تحديد الضغط وعمق اللون
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// تنفيذ العملية
PdfConverter.Convert(options);

يُظهر المثال تحويل مستند PDF إلى صيغة TIFF إلى تدفقات.

// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_input.pdf"));
// تنفيذ العملية
var results = PdfConverter.Convert(options);
// الحصول على نتائج التدفق
foreach (var result in results.ResultCollection)
{
    var streamResultPage1 = result.ToStream();
}

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

Convert(PdfToPdfAOptions)

يقوم بتحويل مستند PDF إلى صيغة PDF/A.

public static ResultContainer Convert(PdfToPdfAOptions options)

المعلمات

  • options PdfToPdfAOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية تحويل مستند PDF إلى صيغة PDF/A (PDF/A-3b في هذه الحالة):

// إنشاء فئة الخيارات لتكوين عملية التحويل
var options = new PdfToPdfAOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

// إضافة الملف المصدر
options.AddInput(new FileData("path_to_your_pdf_file.pdf")); // استبدل بمسار الملف الفعلي

// إضافة مسار حفظ الملف المحوَّل
options.AddOutput(new FileData("path_to_the_converted_file.pdf"));

// تشغيل التحويل
PdfConverter.Convert(options);

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

Validate(PdfAValidateOptions)

يفحص مستند PDF للامتثال للصيغة المحددة PDF/A.

public static ResultContainer Validate(PdfAValidateOptions options)

المعلمات

  • options PdfAValidateOptions: كائن خيارات يحتوي على التعليمات للعملية.

القيمة المرجعة

ResultContainer : كائن يحتوي على نتيجة العملية.

أمثلة

يُظهر المثال كيفية التحقق من توافق مستند PDF مع صيغة PDF/A (PDF/A-1a في هذه الحالة):

// إنشاء فئة الخيارات لتكوين عملية التحقق
var options = new PdfAValidateOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_1A
};

// إضافة ملف أو أكثر للتحقق
options.AddInput(new FileData("path_to_your_first_pdf_file.pdf")); // استبدل بمسار الملف الفعلي
options.AddInput(new FileData("path_to_your_second_pdf_file.pdf"));
// أضف المزيد من الملفات حسب الحاجة

// تشغيل التحقق والحصول على النتائج
var resultContainer = PdfConverter.Validate(options);

// فحص الخاصية ResultCollection للحصول على نتائج التحقق لكل ملف:
foreach (var result in resultContainer.ResultCollection)
{
    var validationResult = (PdfAValidationResult) result.Data;
    var isValid = validationResult.IsValid; // نتيجة التحقق للمستند
}

الاستثناءات

ArgumentException

إذا لم يتم تعيين الخيارات.

مساحة الأسماء: Documentize التجميع: Documentize.dll

 عربي