ما الجديد الأقسام الفرعية
v26.9
- يتم إيقاف التنفيذ السابق للملحقات تدريجياً. تم استبدال وظائف هذه الفئة بالفئة PdfForm.
- Class FormFlattener: تم إزالتها، استخدم PdfForm.
مثال على الاستخدام:
يوضح المثال كيفية تسطيح الحقول في ملف PDF.
// إنشاء كائن FlattenFieldsOptions لتحديد التعليمات
var options = new FlattenFieldsOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfForm.Flatten(options);
مثال على الاستخدام:
يوضح المثال كيفية تسطيح الحقول في ملف PDF وتخطي الحقل الأول.
// الحصول على أسماء الحقول
var fieldNames = PdfForm.GetNames(new GetFieldNamesOptions("path_to_your_pdf_file.pdf"));
// إنشاء كائن FlattenFieldsOptions لتحديد التعليمات
var options = new FlattenFieldsOptions();
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// تخطي حقل واحد.
options.SkipFields.Add(fieldNames[0]);
// تنفيذ العملية
PdfForm.Flatten(options);
تم إعادة تصميم الفئة GetFieldNamesOptions
- تورث من الفئة OptionsWithInput.
- تمت إضافة الخاصية Input.
مثال على الاستخدام:
يوضح المثال كيفية الحصول على أسماء الحقول من ملف PDF.
// الحصول على أسماء الحقول
var fieldNames = PdfForm.GetNames(new GetFieldNamesOptions("path_to_your_pdf_file.pdf"));
مثال على الاستخدام:
يوضح المثال كيفية الحصول على أسماء الحقول من تدفق PDF.
// إعداد تدفق الإدخال
using var inputStream = File.OpenRead("path_to_your_pdf_file.pdf");
// الحصول على أسماء الحقول
var fieldNames = PdfForm.GetNames(new GetFieldNamesOptions(inputStream));
إصلاحات أخرى
📄 PDF إلى DOC
- تم إصلاح حدوث استثناء OutOfMemoryException أثناء التحويل من PDF إلى DOC
- تم إصلاح مشكلة عرض شعار التذييل المكسور في تحويل PDF إلى HTML
🖼️ PDF إلى JPEG
- تم إصلاح حدوث استثناء OutOfMemoryException أثناء التحويل من PDF إلى JPEG
- تم إصلاح حدوث استثناء InvalidOperationException أثناء التحويل إلى PNG
- تم إصلاح فقدان معلومات في إخراج PDF إلى TIFF
📑 PDF إلى PDF/A
- تم إصلاح أن إخراج PDF إلى PDF/A غير صالح لـ PDF/A-1b أو PDF/A-3b
- تم إصلاح حدوث استثناء InvalidCastException أثناء التحويل إلى PDF/A-2b
v26.8
تم إعادة تصميم فئة SignOptions
- الآن أصبح استخدامه أسهل.
- وراثة من فئة OptionsWithInputAndOutput.
- تم تغيير الخاصيتين Inputs و Outputs إلى Input و Output. الآن هناك مدخل ومخرج واحد فقط.
- إذا كان الناتج ملفًا، فسيتم إغلاق التيار (Stream) الخاص به تلقائيًا، أما إذا كان Stream فسيظل مفتوحًا للاستخدام لاحقًا.
- تم حذف الطريقتين AddInput و AddOutput.
- أضيفت عدة مُنشئات أكثر ملاءمة:
SignOptions(IData inputData, IData outputData, IData pfxData, string password)SignOptions(string inputFile, string outputFile, string pfxFile, string pfxPassword)SignOptions(Stream inputStream, Stream outputStream, Stream pfxStream, string pfxPassword)
- أضيفت خصائص قابلة للتعديل:
Stream Pfxstring PfxPasswordIData InputIData Output
مثال على الاستخدام:
مثال على العمل مع SignOptions.
using var pfxStream = File.OpenRead(@"path_to_your_pfx_file.pfx");
var options = new SignOptions(pfxStream, "password_of_your_pfx_file");
// Set input and output file paths
options.Input = new FileData("path_to_your_pdf_file.pdf");
options.Output = new FileData("path_to_result_pdf_file.pdf");
مثال على الاستخدام:
يوضح المثال كيفية توقيع ملف PDF بأقصر أسلوب ممكن.
PdfSecurity.Sign(new SignOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf", "path_to_your_pfx_file.pfx", "password_of_your_pfx_file"));
مثال على الاستخدام:
يوضح المثال كيفية توقيع مستند PDF باستخدام التيارات.
// Prepare streams
using var pdfStreamInput = File.OpenRead(@"path_to_your_pdf_file.pdf");
using var pfxStreamInput = File.OpenRead(@"path_to_your_pfx_file.pfx");
using var pdfStreamOutput = new MemoryStream();
// Create SignOptions object to set instructions
var options = new SignOptions(pdfStreamInput, pdfStreamOutput, pfxStreamInput, "password_of_your_pfx_file");
// Perform the process
PdfSecurity.Sign(options);
تم إزالة الفئة Signature
- يتم إيقاف تنفيذ الإضافات (plugins) القديمة تدريجيًا. تم استبدال وظائف هذه الفئة بالفئة PdfSecurity.
- Class Signature: تم الحذف، استخدم PdfSecurity.
مثال على الاستخدام:
يوضح المثال كيفية توقيع مستند PDF.
// Create SignOptions object to set instructions
var options = new SignOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf", "path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
// Perform the process
PdfSecurity.Sign(options);
- يتم إيقاف تنفيذ الإضافات (plugins) القديمة تدريجيًا. تم استبدال وظائف هذه الفئة بالفئات PdfExtractor و PdfForm.
- Class FormExporter: تم الحذف، استخدم PdfExtractor أو PdfForm.
مثال على الاستخدام:
يوضح المثال كيفية تصدير قيم النماذج إلى ملف CSV باستخدام PdfExtractor.
// Create ExtractFormDataToDsvOptions object to set instructions
var options = new ExtractFormDataToDsvOptions(',', true);
// Add input file path
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileData("path_to_result_csv_file.csv"));
// Perform the process
PdfExtractor.Extract(options);
مثال على الاستخدام:
يوضح المثال كيفية تصدير قيم النماذج إلى ملف TSV وتعيين الخصائص باستخدام PdfForm.
// Create ExtractFormDataToDsvOptions object to set instructions
var options = new ExtractFormDataToDsvOptions();
// Set Delimiter
options.Delimiter = '\t';
// Add Field Names to result
options.AddFieldName = true;
// Add input file path
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileData("path_to_result_csv_file.tsv"));
// Perform the process
PdfForm.Extract(options);
تحسين الفئة FileData
- تم تجاوز طريقة
ToString().
إصلاحات أخرى
📄 PDF إلى DOC
- تم إصلاح استغراق تحويل PDF إلى DOC وقتًا مفرطًا
🌐 PDF إلى HTML / HTML إلى PDF
- تم إصلاح تحويل PDF إلى HTML الذي ينتج صورًا شفافة
- تم إصلاح تحويل HTML إلى PDF حيث كان المحتوى يتداخل
- تم إصلاح تحويل HTML إلى PDF حيث تم تجاهل عرض الجدول
🖼️ PDF إلى PNG / TIFF
- تم إصلاح تحويل PDF إلى PNG الذي كان يستهلك ذاكرة مفرطة
- تم إصلاح تحويل PDF إلى PNG الذي لم يحافظ على الخطوط المضمّنة
- تم إصلاح تحويل PDF إلى TIFF الذي كان يطرح استثناءً
📑 PDF إلى PDF/A
- تم إصلاح تحويل PDF إلى PDF/A الذي فقد ألوان المستند
- تم إصلاح تحويل PDF إلى PDF/A الذي كان يتداخل النص في المخرجات
- تم إصلاح طريقة
Validate() في PDF/A التي كانت تُرجع نتائج غير صحيحة - تم إصلاح تحقق PDF/A الذي كان ينتج نتائج غير صحيحة
📂 عمليات أخرى
- تم إصلاح
System.FormatException الذي كان يُطرح عند التحقق من توقيع PDF - تم إصلاح دمج المستندات الذي كان يطرح استثناءً
v26.7
- يتم إيقاف تنفيذ المكوّنات الإضافية السابقة تدريجياً. تم استبدال وظائف هذه الفئة بالفئة PdfExtractor.
- Class ImageExtractor: تم حذفها، استخدم PdfExtractor.
مثال على الاستخدام:
يوضح المثال كيفية استخراج الصور من مستند PDF.
// Create ExtractImagesOptions to set instructions
var options = new ExtractImagesOptions();
// Add input file path
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryData("path_to_results_directory"));
// Perform the process
var results = PdfExtractor.Extract(options);
// Get path to image result
var imageExtracted = results.ResultCollection[0].ToFile();
تم إزالة Class Timestamp
- تم استبدال وظائف هذه الفئة بالفئة PdfSecurity.
- Class Timestamp: تم حذفها، استخدم PdfSecurity.
- Class AddTimestampOptions: تم حذفها، استخدم SignOptions و TimestampOptions.
مثال على الاستخدام:
يوضح المثال كيفية توقيع مستند PDF باستخدام الطابع الزمني.
// Create SignOptions object to set Timestamp
var options = new SignOptions(new TimestampOptions("server_url"));
// Add input file path
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Perform the process
PdfSecurity.Sign(options);
إصلاحات أخرى
🖥️ HTML إلى PDF
- تم إصلاح تحويل HTML إلى PDF حيث كان يحدث وضع غير صحيح للصور وتجاوز النص.
- تم إصلاح تحويل HTML إلى PDF حيث لم يتناسب محتوى الصفحة بشكل صحيح.
- تم إصلاح مشكلة ظهور شريط أسود في PDF المُنتج.
📑 PDF إلى PDF/A
- تم إصلاح استثناء يتم إلقاؤه من API تحويل PDF إلى PDF/A.
- تم إصلاح تحويل PDF إلى PDF/A الذي كان ينتج مخرجات بتنسيق غير صحيح.
- تم إصلاح مشكلة الذاكرة أثناء تحويل PDF إلى PDF/A.
- تم إصلاح مشكلة التحويل إلى PDF/A-3a.
⚙️ المتبقي
- تم إصلاح فقدان محتوى النص عند تحويل PDF إلى PNG وHTML.
- تم إصلاح مشكلة أن بعض الحقول أصبحت فارغة بعد التسوية.
- تم إصلاح مشكلة ظهور خطأ في مستند PDF بعد التسوية.
- تم إصلاح مشكلة أن تحسين PDF يسبب تشويه تنسيق المحتوى.
v26.6
PdfSecurity: إضافة إمكانية توقيع PDF بطابع زمني بدون PFX
- الآن يمكنك إضافة طابع زمني إلى مستند PDF دون الحاجة إلى تحديد ملف PFX وكلمة المرور.
- Class SignOptions: لديها مُنشئ مع Class TimestampOptions.
مثال للاستخدام:
يوضح المثال كيفية توقيع مستند PDF بطابع زمني.
// إنشاء كائن SignOptions لتعيين الطابع الزمني
var options = new SignOptions(new TimestampOptions("server_url"));
// إضافة مسار ملف الإدخال
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfSecurity.Sign(options);
- يتم تقنين تنفيذ الإضافات السابقة تدريجياً. تم استبدال وظيفة هذه الفئة إلى PdfExtractor.
- Class TextExtractor: تمت إزالتها، استخدم PdfExtractor.
إضافة مزيد من المعلومات والإرشادات للكيانات الجديدة
- إضافة تعليقات XML لـ OptionsWithInputAndOutput و SanitizeOptions.
- إضافة معلومات حول القيم الافتراضية في SanitizeOptions.
إضافة معلومات حول التطهير إلى المستندات والمنتجات
إصلاح استثناء عند تحويل HTML إلى PDF
إصلاحات أخرى
📄 عام / النظام
- إصلاح دمج مستندات PDF الفاسدة
- إصلاح معالجة الملفات الفاسدة
- إصلاح
System.StackOverflowException عند فتح ملف PDF - إصلاح توقف استخراج النص على ملفات PDF معينة
🌐 HTML → PDF
- إصلاح تحويل HTML إلى PDF: ظهور أحرف صينية بشكل غير صحيح
📑 PDF → DOC
- إصلاح PDF إلى DOC: لا يزال تسليط الضوء يغطي النص
- إصلاح PDF إلى DOC: ظهور الصور بصورة غير صحيحة
- إصلاح مشكلة أداء تحويل PDF إلى DOC
📊 PDF → Excel
- إصلاح PDF إلى Excel: تم تجاهل صورة الجدول
🖼️ PDF → PNG
- إصلاح PDF إلى PNG: تستغرق عملية التحويل وقتًا مفرطًا
🛡️ PDF → PDF/A
- إصلاح فقدان التوافق مع PDF A-1A وتلف النماذج بعد الحفظ
- إصلاح مشكلة وقت تحويل PDF إلى PDFA
- إصلاح فقدان الشفافية الجزئية أثناء التحويل إلى PDFA
- إصلاح مشكلة تداخل النصوص في PDFA
- إصلاح مشكلة عرض النص في PDFA
- إصلاح فساد المستند عند التحويل إلى PDFA3b
v26.5
ميزة جديدة: تنقية ملفات PDF للأمان
- تنقية البيانات المخفية من مستند PDF، مع التأكد من إزالة أو تحويل المعلومات الحساسة أو غير الضرورية مثل البيانات التعريفية، المرفقات، التعليقات التوضيحية، جافا سكريبت، النماذج، الطبقات، فهرس البحث، أو المحتوى الخاص.
- Class PdfSecurity: تم إضافة طريقة Sanitize لتنقية مستند PDF.
- Class SanitizeOptions: تمثل خيارات التكوين لتنقية البيانات المخفية داخل مستند بالنسبة لفئة PdfSecurity.
- Property Input: الحصول على بيانات الإدخال أو تعيينها.
- Property Output: الحصول على بيانات الإخراج أو تعيينها.
- Property ConvertPagesToImages: الحصول على خيار تحويل الصفحات إلى صور أو تعيينه.
- Property ImageDpi: الحصول على خيار تحديد DPI للصور أثناء تحويل الصفحات إلى صور أو تعيينه.
- Property RemoveAnnotations: الحصول على قيمة تشير إلى ما إذا كانت التعليقات التوضيحية ستحذف من المستند أو تعيينها.
- Property RemoveSearchIndexAndPrivateInfo: الحصول على قيمة تشير إلى ما إذا كان فهرس البحث والمعلومات الخاصة ستحذف من المستند أو تعيينها.
- Property FlattenForms: الحصول على قيمة تشير إلى ما إذا كان يجب تسطيح النماذج في المستند أثناء عملية التنقية أو تعيينها.
- Property FlattenLayers: الحصول على خيار تسطيح الطبقات في مستند PDF أو تعيينه.
- Property RemoveJavaScriptsAndActions: الحصول على قيمة تشير إلى ما إذا كان يجب إزالة جافا سكريبت والإجراءات المرتبطة من المستند أو تعيينها.
- Property RemoveMetadata: الحصول على خيار إزالة البيانات التعريفية من المستند أو تعيينه.
- Property RemoveAttachments: الحصول على خيار إزالة جميع الملفات المرفقة من المستند أو تعيينه.
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية مستند PDF.
// Create SanitizeOptions object to set input and output files
var options = new SanitizeOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf");
// Perform the process
PdfSecurity.Sanitize(options);
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية PDF من تدفق إلى تدفق.
// Prepare input and output streams
using var inputStream = File.OpenRead("path_to_your_pdf_file.pdf");
using var outputStream = new MemoryStream();
// Create SanitizeOptions object to set input and output streams
var options = new SanitizeOptions(inputStream, outputStream);
// Perform the process
PdfSecurity.Sanitize(options);
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية PDF من ملف إلى تدفق.
// Prepare output stream
using var outputStream = new MemoryStream();
// Create SanitizeOptions object to set input file and output stream
var options = new SanitizeOptions("path_to_your_pdf_file.pdf", outputStream);
// Perform the process
PdfSecurity.Sanitize(options);
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية PDF من ملف إلى تدفق مع ضبط يدوي لخصائص الإدخال والإخراج.
// Create SanitizeOptions object
var options = new SanitizeOptions();
//Set Input file
options.Input = new FileData("path_to_your_pdf_file.pdf");
//Set Output file
options.Output = new FileData("path_to_result_pdf_file.pdf");
// Perform the process
PdfSecurity.Sanitize(options);
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية PDF دون إزالة البيانات التعريفية.
// Create SanitizeOptions object to set input and output files
var options = new SanitizeOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf");
options.RemoveMetadata = false;
// Perform the process
PdfSecurity.Sanitize(options);
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية PDF دون إزالة المرفقات.
// Create SanitizeOptions object to set input and output files
var options = new SanitizeOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf");
options.RemoveAttachments = false;
// Perform the process
PdfSecurity.Sanitize(options);
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية PDF مع تحويل جميع الصفحات إلى صور وتحديد DPI للنتيجة.
// Create SanitizeOptions object to set input and output files
var options = new SanitizeOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf");
// Turn on conversion and set dpi
options.ConvertPagesToImages = true;
options.ImageDpi = 200;
// Perform the process
PdfSecurity.Sanitize(options);
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية PDF دون إزالة جافا سكريبت والإجراءات.
// Create SanitizeOptions object to set input and output files
var options = new SanitizeOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf");
options.RemoveJavaScriptsAndActions = false;
// Perform the process
PdfSecurity.Sanitize(options);
مثال على الاستخدام:
يوضح هذا المثال كيفية تنقية ملف PDF بأقصر أسلوب ممكن.
PdfSecurity.Sanitize(new SanitizeOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf"));
- تمثل الخيارات الأساسية للعمليات التي تتضمن بيانات إدخال واحدة وبيانات إخراج واحدة.
- مستندة إلى OptionsWithInput.
- Property Input: الحصول على بيانات الإدخال أو تعيينها.
- Property Output: الحصول على بيانات الإخراج أو تعيينها.
تحسين أداء تحويل PDF إلى JPEG
تحديث صفحة المنتج “FAQs” لهذا الموقع
https://docs.documentize.com/faqs/
إصلاحات أخرى
- تم إصلاح مشكلة بطء تحويل HTML كبير إلى PDF
- تم إصلاح مشكلة حدوث OutOfMemoryException عند تحويل PDF إلى HTML
- تم إصلاح مشكلة قطع محتوى الصفحات عند تحويل PDF إلى PDFA
- تم إصلاح مشكلة عرض الصور الشفافة عند تحويل PDF إلى PDFA
- تم إصلاح فقدان التعليقات التوضيحية في النتيجة عند تحويل PDF إلى PDFA2b
- تم إصلاح ظهور الصورة مقلوبة في ملف النتيجة عند تحويل PDF إلى PDF/A
- تم إصلاح فشل الملف الناتج في امتثال PDF/A_2a عند تحويل PDF إلى PDF/A
- تم إصلاح فشل الملف الناتج في الامتثال عند تحويل PDF إلى PDF/A
- تم إصلاح تحول التوقيع إلى اللون الأسود بعد التحويل إلى PDF/A
- تم إصلاح تغير محاذاة النص بشكل غير متوقع عند تحويل PDF إلى PDF/A
- تم إصلاح استغراق تحويل PDF إلى PNG وقتًا مفرطًا
- تم إصلاح صورة الإخراج غير الصحيحة عند تحويل PDF إلى PNG
- تم إصلاح ظهور خطوط مظلمة في صورة الإخراج عند تحويل PDF إلى PNG
- تم إصلاح عدم القدرة على التحقق من امتثال PDF/A_1b للمستند.
v26.4
- طريقة PdfExtractor.Extract: لا يطلق استثناء إذا لم يتم العثور على تواريخ الإنشاء والتعديل في المستند المدخل.
- خاصية PdfProperties.Created: تُعيد
null إذا لم يتم العثور على القيمة في المستند المدخل. تم تغيير نوع البيانات من “DateTime” إلى “DateTime?”. - خاصية PdfProperties.Modified: تُعيد
null إذا لم يتم العثور على القيمة في المستند المدخل. تم تغيير نوع البيانات من “DateTime” إلى “DateTime?”.
مثال على الاستخدام:
يوضح المثال كيفية استخراج خصائص الإنشاء والتعديل
// Create ExtractPropertiesOptions object to set input file
var options = new ExtractPropertiesOptions("path_to_your_pdf_file.pdf");
// Perform the process and get Properties
var pdfProperties = PdfExtractor.Extract(options);
var created = pdfProperties.Created;
var modified = pdfProperties.Modified;
تحسين أداء تحويل PDF إلى TIFF
إنشاء صفحة منتج لـ “PDF Converter” لهذا الموقع
https://products.documentize.com/pdf-converter/
إصلاحات أخرى
- تم إصلاح HTML إلى PDF – الأداء كان بطيئاً جداً مع نص HTML كبير
- تم إصلاح HTML إلى PDF – الرأس والتذييل لا يظهران في الصفحات التالية
- تم إصلاح HTML إلى PDF – أداة التلميح لا تُظهر بشكل صحيح
- تم إصلاح PDF إلى DOC – التحويل ينتج استثناء OutOfMemory
- تم إصلاح PDF إلى XLS – الأعمدة المدمجة تُجمع في عمود واحد
- تم إصلاح PDF إلى HTML – الصور الخلفية مفقودة
- تم إصلاح PDF إلى HTML – الروابط المحلية لا تُعرض
- تم إصلاح PDF إلى JPEG – الصورة الناتجة تظهر باللون الأسود
- تم إصلاح PDF إلى PDF/A – مشاكل تنسيق في الملف الناتج
- تم إصلاح PDF إلى PDF/A_1b – الملف الناتج غير متوافق
- تم إصلاح PDF إلى PDF/A_3b – مشاكل تنسيق النص في الملف الناتج
- تم إصلاح PDF إلى PDF/A-2B – التحويل يزيل الأحرف الرياضية عند استخدام خطوط OpenType MATH
v26.3
تم إعادة تسمية IDataSource إلى IData
- Interface IDataSource: تمت إعادة تسميتها إلى IData.
- أصبحت فئات الخيارات أسهل في الاستخدام.
تم إعادة تسمية FileDataSource إلى FileData
- Class FileDataSource: تمت إعادة تسميتها إلى FileData.
- أصبحت فئات الخيارات أسهل في الاستخدام.
- تم تحديث وتع fixing تعليقات XML.
- تم تحديث جميع الأمثلة التي تشمل Input و Output.
مثال على الاستخدام:
يوضح المثال كيفية استخدام FileData في Input و Output.
// Create EncryptOptions object to set instructions
var options = new EncryptOptions("123456", "qwerty");
// Add input file path
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Perform the process
PdfSecurity.Encrypt(options);
تم إعادة تسمية StreamDataSource إلى StreamData
- Class StreamDataSource: تمت إعادة تسميتها إلى StreamData.
- أصبحت فئات الخيارات أسهل في الاستخدام.
- تم تحديث وتع fixing تعليقات XML.
- تم تحديث جميع الأمثلة التي تشمل Input و Output.
مثال على الاستخدام:
يوضح المثال كيفية استخدام StreamData في Output.
// Create TocOptions object to set instructions
var options = new TocOptions();
// Set the Title
options.Title = "My Table of Contents";
// Design Headings
options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
// Add input file path
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Set output stream
var outputStream = new MemoryStream();
options.AddOutput(new StreamData(outputStream));
options.CloseOutputStreams = false;
// Perform the process
PdfManager.AddTableOfContents(options);
تم إعادة تسمية DirectoryDataSource إلى DirectoryData
- Class DirectoryDataSource: تمت إعادة تسميتها إلى DirectoryData.
- أصبحت فئات الخيارات أسهل في الاستخدام.
- تم تحديث جميع الأمثلة التي تشمل Input و Output.
مثال على الاستخدام:
يوضح المثال كيفية تصدير قيم النماذج إلى ملف TSV وتعيين الخصائص.
// Create PdfToTiffOptions object to set instructions
var options = new PdfToTiffOptions();
// Add input file path
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryData("path_to_output_directory"));
// Perform the process
PdfConverter.Convert(options);
تم تصحيح خطأ إملائي في الكلمة.
مثال على الاستخدام:
يوضح المثال كيفية تصدير قيم النماذج إلى ملف TSV وتعيين الخصائص.
// Create ExtractFormDataToDsvOptions object to set instructions
var options = new ExtractFormDataToDsvOptions();
//Set Delimiter
options.Delimiter = '\t';
//Add Field Names to result
options.AddFieldName = true;
// Add input file path
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileData("path_to_result_csv_file.tsv"));
// Perform the process
PdfExtractor.Extract(options);
تم إنشاء صفحة منتج لـ “PDF Manager” لهذا الموقع
https://products.documentize.com/pdf-manager/
https://products.documentize.com/pdf-form/
تم إصلاح المشكلات
- تم إصلاح مشكلة حيث كان تحويل صورة إلى PDF يسبب استثناء نفاد الذاكرة.
- تم إصلاح مشكلة حيث كان إنشاء جدول المحتويات ينتج نتائج غير صحيحة.
- تم إصلاح مشكلة حيث كانت خاصية OptimizeResources UnembedFonts تُسبب استثناء.
- تم إصلاح مشكلة حيث لم يطبق تحويل PDF إلى HTML الخطوط بشكل صحيح عند العرض في Internet Explorer.
- تم إصلاح مشكلة حيث كان تحويل PDF إلى HTML ينتج عناصر ومقاطع تنسيق في غير محلها.
- تم إصلاح مشكلة حيث كان عملية تحويل PDF إلى PDF/A تتعطل.
- تم إصلاح مشكلة حيث كان تحويل PDF إلى PDF/A يزيل حقول النموذج وقيمها.
- تم إصلاح مشكلة حيث كان مخرجات تحويل PDF إلى PDF/A غير متوافقة مع PDF/A_1a.
- تم إصلاح مشكلة حيث كان مخرجات تحويل PDF إلى PDF/A غير متوافقة مع PDF/A_2b.
- تم إصلاح مشكلة حيث فشل مخرجات تحويل PDF إلى PDF/A-3A في اختبار التوافق Preflight.
- تم إصلاح مشكلة حيث فشل مخرجات تحويل PDF إلى PDF/A-3B في اختبار التوافق Preflight.
v26.2
تحسين استخراج خصائص المستندات لملف PDF
- Class Extractor: يمكنه استخراج البيانات الوصفية الجديدة من مستندات PDF.
- Class PdfProperties: أضيفت الخصائص: FileName، Created، Modified، Application، PdfProducer.
مثال على الاستخدام:
يوضح المثال كيفية استخراج الخصائص (FileName، Title، Author، Subject، Keywords، Created، Modified، Application، PDF Producer، Number of Pages) من ملف PDF.
// Create ExtractPropertiesOptions object to set input file
var options = new ExtractPropertiesOptions("path_to_your_pdf_file.pdf");
// Perform the process and get Properties
var pdfProperties = PdfExtractor.Extract(options);
var filename = pdfProperties.FileName;
var title = pdfProperties.Title;
var author = pdfProperties.Author;
var subject = pdfProperties.Subject;
var keywords = pdfProperties.Keywords;
var created = pdfProperties.Created;
var modified = pdfProperties.Modified;
var application = pdfProperties.Application;
var pdfProducer = pdfProperties.PdfProducer;
var numberOfPages = pdfProperties.NumberOfPages;
مثال على الاستخدام:
يوضح المثال كيفية استخراج الخصائص (Title، Author، Subject، Keywords، Created، Modified، Application، PDF Producer، Number of Pages) من تدفق PDF.
// Create ExtractPropertiesOptions object to set input stream
var stream = File.OpenRead("path_to_your_pdf_file.pdf");
var options = new ExtractPropertiesOptions(stream);
// Perform the process and get Properties
var pdfProperties = PdfExtractor.Extract(options);
var title = pdfProperties.Title;
var author = pdfProperties.Author;
var subject = pdfProperties.Subject;
var keywords = pdfProperties.Keywords;
var created = pdfProperties.Created;
var modified = pdfProperties.Modified;
var application = pdfProperties.Application;
var pdfProducer = pdfProperties.PdfProducer;
var numberOfPages = pdfProperties.NumberOfPages;
تحسين استخراج النص لملف PDF
- أصبح التعامل مع استخراج النص ومعلمات الاستخراج أسهل الآن: يمكنك تحديد بيانات الإدخال والحصول على النتيجة بسهولة أكبر مقارنةً بالسابق.
- Class ExtractTextOptions: تُطبق الواجهة IHaveInput. تُستَخدم بيانات إدخال واحدة فقط. أنواع البيانات المسموح بها: File و Stream.
- Method Extract(ExtractTextOptions options): تُعيد سلسلة نصية تحتوي على النتائج.
- Object ResultContainer: تمت إزالته من ExtractTextOptions.
مثال على الاستخدام:
يوضح المثال كيفية استخراج محتوى النص من ملف PDF.
// Create ExtractTextOptions object to set input file path
var options = new ExtractTextOptions("path_to_your_pdf_file.pdf");
// Perform the process and get the extracted text
var textExtracted = PdfExtractor.Extract(options);
مثال على الاستخدام:
يوضح المثال كيفية استخراج محتوى النص من تدفق PDF.
// Create ExtractTextOptions object to set input stream
var stream = File.OpenRead("path_to_your_pdf_file.pdf");
var options = new ExtractTextOptions(stream);
// Perform the process and get the extracted text
var textExtracted = PdfExtractor.Extract(options);
مثال على الاستخدام:
يوضح المثال كيفية استخراج محتوى النص من مستند PDF مع TextFormattingMode.
// Create ExtractTextOptions object to set input file path and TextFormattingMode
var options = new ExtractTextOptions("path_to_your_pdf_file.pdf", TextFormattingMode.Pure);
// Perform the process and get the extracted text
var textExtracted = PdfExtractor.Extract(options);
مثال على الاستخدام:
يوضح المثال كيفية استخراج النص من ملف PDF بأقصر أسلوب ممكن.
// Perform the process and get the extracted text
var textExtracted = PdfExtractor.Extract(new ExtractTextOptions("path_to_your_pdf_file.pdf", TextFormattingMode.Pure));
إصلاح الأخطاء
- فشل تحويل ملفات Jpeg2000 إلى PDF
- مشكلة دمج ملفات PDF
- تعديل حجم صفحة PDF ينتج مخرجات فارغة
- PDF إلى HTML: اللون المظلل ظاهر لكن النص مفقود
- PDF إلى HTML: تم إنشاء مخرجات HTML غير صحيحة
- PDF إلى HTML: النص الرأسي على الجانب الأيسر مفقود
- PDF إلى HTML: النص في الرأس يختفي
- PDF إلى HTML: النص المشروح الشفاف غير مرئي
- PDF إلى PNG: فشل عرض بعض الأحرف الصينية
v26.1
- استخراج خصائص الـ PDF: العنوان، المؤلف، الموضوع، الكلمات المفتاحية، عدد الصفحات.
- Class PdfExtractor: أضيفت طريقة
Extract لاستخراج خصائص الـ PDF. - Class ExtractPropertiesOptions: تمثل خيارات استخراج خصائص الـ PDF لإضافة PdfExtractor.
- Class PdfProperties: تمثل الخصائص والمعلومات الوصفية لوثيقة الـ PDF.
- Interface IHaveInput: تُستخدم للخيارات التي تتطلب بيانات إدخال واحدة.
- Class OptionsWithInput: تُستخدم للخيارات التي تتطلب بيانات إدخال واحدة.
- وظيفة مجانية بالكامل.
مثال على الاستخدام:
يوضح المثال كيفية استخراج الخصائص (العنوان، المؤلف، الموضوع، الكلمات المفتاحية، عدد الصفحات) من ملف PDF.
// Create ExtractPropertiesOptions object to set input file
var options = new ExtractPropertiesOptions("path_to_your_pdf_file.pdf");
// Perform the process and get Properties
var pdfProperties = PdfExtractor.Extract(options);
var title = pdfProperties.Title;
var author = pdfProperties.Author;
var subject = pdfProperties.Subject;
var keywords = pdfProperties.Keywords;
var numberOfPages = pdfProperties.NumberOfPages;
مثال على الاستخدام:
يوضح المثال كيفية استخراج الخصائص (العنوان، المؤلف، الموضوع، الكلمات المفتاحية، عدد الصفحات) من تدفق PDF.
// Create ExtractPropertiesOptions object to set input stream
var stream = File.OpenRead("path_to_your_pdf_file.pdf");
var options = new ExtractPropertiesOptions(stream);
// Perform the process and get Properties
var pdfProperties = PdfExtractor.Extract(options);
var title = pdfProperties.Title;
var author = pdfProperties.Author;
var subject = pdfProperties.Subject;
var keywords = pdfProperties.Keywords;
var numberOfPages = pdfProperties.NumberOfPages;
مثال على الاستخدام:
يوضح المثال كيفية استخراج الخصائص من ملف PDF بأقصر طريقة ممكنة.
// Perform the process and get Properties
var pdfProperties = PdfExtractor.Extract(new ExtractPropertiesOptions("path_to_your_pdf_file.pdf"));
التحسينات
- تحسين تحويل HTML إلى PDF يدعم النص البديل للصور
- توافق PDF إلى PDFA1b
الأخطاء التي تم إصلاحها
- حدوث خطأ عند محاولة تحسين ملف PDF
- مشكلة محاذاة عمودية لحقل النموذج
- تم إصلاح مشكلة عرض النص الياباني في حقل النموذج
- مشكلة تنسيق الجدول في تحويل HTML إلى PDF
- تحسين حجم الـ PDF قبل التحويل إلى PDF/A أدى إلى إخراج معطل
- مشكلة عرض الجدول بشكل غير صحيح عند التحويل من PDF إلى DOC
- مشاكل تنسيق ملف الإخراج عند التحويل من PDF إلى Excel
- استثناء
ArgumentException أثناء التحويل من PDF إلى HTML - فقدان بعض الروابط في تحويل PDF إلى HTML
- فقدان النص عند تحويل PDF إلى HTML
v25.12
- Class PdfForm: يحتوي على جميع وظائف الإضافات: FormFlattener، FormExporter. كما يسمح بحذف الحقول والحصول عليها.
- Class FormFlattener: سيُحذف قريبًا، استخدم PdfForm.
- Class FormFlattenerOptions: تم إعادة تسميتها إلى Class FlattenFieldsOptions.
- Class GetFieldNamesOptions: يسمح بتعيين الخيارات للحصول على أسماء الحقول.
- Class RemoveFieldsOptions: يسمح بتعيين الخيارات لإزالة الحقول.
- راجع The New Plugin Architecture.
مثال على الاستخدام:
يوضح المثال كيفية تسوية الحقول في ملف PDF.
// Create FlattenFieldsOptions object to set instructions
var options = new FlattenFieldsOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfForm.Flatten(options);
مثال على الاستخدام:
يوضح المثال كيفية الحصول على أسماء الحقول من ملف PDF.
var fieldNames = PdfForm.GetNames(new GetFieldNamesOptions("path_to_your_pdf_file.pdf"));
مثال على الاستخدام:
يوضح المثال كيفية تصدير قيم النموذج إلى ملف CSV.
// Create ExtractFormDataToDsvOptions object to set instructions
var options = new ExtractFormDataToDsvOptions(',', true);
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// Perform the process
PdfForm.Extract(options);
مثال على الاستخدام:
يوضح المثال كيفية إزالة الحقول من ملف PDF.
// Create RemoveFieldsOptions object to set instructions
var options = new RemoveFieldsOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfForm.Remove(options);
- Method ExtractText: تم إعادة تسميتها إلى Method Extract.
- Method ExtractImages: تم إعادة تسميتها إلى Method Extract.
- Method ExtractFormData: تم إعادة تسميتها إلى Method Extract.
مثال على الاستخدام:
يوضح المثال كيفية استخراج النص من مستند PDF.
// Create ExtractTextOptions object to set instructions
var options = new ExtractTextOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Perform the process
var results = PdfExtractor.Extract(options);
// Get the extracted text from the ResultContainer object
var textExtracted = results.ResultCollection[0].ToString();
مثال على الاستخدام:
يوضح المثال كيفية استخراج الصور من مستند PDF.
// Create ExtractImagesOptions to set instructions
var options = new ExtractImagesOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// Perform the process
var results = PdfExtractor.Extract(options);
// Get path to image result
var imageExtracted = results.ResultCollection[0].ToFile();
مثال على الاستخدام:
يوضح المثال كيفية تصدير قيم النموذج إلى ملف CSV.
// Create ExtractFormDataToDsvOptions object to set instructions
var options = new ExtractFormDataToDsvOptions(',', true);
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// Perform the process
PdfExtractor.Extract(options);
التحسينات
- Class PdfConverterOptions، PdfToXlsOptions - استخدم Class PluginBaseOptions
- تحويل إلى PDF/A-1b
- تحويل إلى PDF/A-2b
الأخطاء التي تم إصلاحها
- تم إصلاح مشكلات تنسيق التحويل من HTML إلى PDF
- فقدت بعض الروابط أثناء التحويل من PDF إلى HTML
v25.11
إضافة جديدة: مكوّن PDF Converter
- Class PdfConverter: يحتوي على جميع وظائف المكوّنات: DocConverter، XlsConverter، HtmlConverter، JpegConverter، PdfAConverter، PngConverter، TiffConverter.
- Class DocConverter: سيتم حذفه قريبًا، استخدم PdfConverter.
- Class XlsConverter: سيتم حذفه قريبًا، استخدم PdfConverter.
- Class HtmlConverter: سيتم حذفه قريبًا، استخدم PdfConverter.
- Class JpegConverter: سيتم حذفه قريبًا، استخدم PdfConverter.
- Class PdfAConverter: سيتم حذفه قريبًا، استخدم PdfConverter.
- Class PngConverter: سيتم حذفه قريبًا، استخدم PdfConverter.
- Class TiffConverter: سيتم حذفه قريبًا، استخدم PdfConverter.
- Class PdfAConvertOptions: تم إعادة تسميتها إلى Class PdfToPdfAOptions.
- راجع The New Plugin Architecture.
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى صيغة Doc.
// Create PdfToDocOptions object to set instructions
var options = new PdfToDocOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_file.doc"));
// Perform the process
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل PDF إلى مستند XLSX.
// Create PdfToXlsOptions object to set instructions
var options = new PdfToXlsOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_xlsx_file.xlsx"));
// Perform the process
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل PDF إلى مستند HTML.
// Create PdfToHtmlOptions object to set output data type as file with embedded resources
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// Add input file path
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_output.html"));
//Perform the process
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند HTML إلى PDF.
// Create HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_input.html"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_output.pdf"));
//Perform the process
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى صيغة JPEG.
// Create PdfToJpegOptions object to set instructions
var options = new PdfToJpegOptions();
// Add input File path
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Perform the process
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى صيغة PNG.
// Create PdfToPngOptions object to set instructions
var options = new PdfToPngOptions();
// Add input File path
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Perform the process
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى صيغة TIFF.
// Create PdfToTiffOptions object to set instructions
var options = new PdfToTiffOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Perform the process
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى صيغة PDF/A (PDF/A-3b في هذا المثال):
// Create the options class to set up the conversion process
var options = new PdfToPdfAOptions
{
PdfAVersion = PdfAStandardVersion.PDF_A_3B
};
// Add the source file
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf")); // replace with your actual file path
// Add the path to save the converted file
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// Run the conversion
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية التحقق من توافق مستند PDF مع صيغة PDF/A (PDF/A-1a في هذا المثال):
// Create the options class to set up the validation process
var options = new PdfAValidateOptions
{
PdfAVersion = PdfAStandardVersion.PDF_A_1A
};
// Add one or more files to be validated
options.AddInput(new FileDataSource("path_to_your_first_pdf_file.pdf")); // replace with your actual file path
options.AddInput(new FileDataSource("path_to_your_second_pdf_file.pdf"));
// add more files as needed
// Run the validation and get results
var resultContainer = PdfConverter.Validate(options);
// Check the resultContainer.ResultCollection property for validation results for each file:
for (var i = 0; i < resultContainer.ResultCollection.Count; i++)
{
var result = resultContainer.ResultCollection[i];
var validationResult = (PdfAValidationResult) result.Data;
var isValid = validationResult.IsValid; // Validation result for the i-th document
}
إضافة جديدة: مكوّن PDF Security
- Class PdfSecurity: يحتوي على جميع وظائف المكوّنات: Security، Signature، Timestamp.
- Class Security: سيتم حذفه قريبًا، استخدم PdfSecurity.
- Class Signature: سيتم حذفه قريبًا، استخدم PdfSecurity.
- Class Timestamp: سيتم حذفه قريبًا، استخدم PdfSecurity.
- Class DecryptionOptions: تم إعادة تسميتها إلى Class DecryptOptions.
- Class EncryptionOptions: تم إعادة تسميتها إلى Class EncryptOptions.
- Class SignOptions: الآن يحتوي على خصائص لـ Class Timestamp.
- راجع The New Plugin Architecture.
مثال على الاستخدام:
يوضح المثال كيفية تشفير مستند PDF.
// Create EncryptOptions object to set instructions
var options = new EncryptOptions("123456", "qwerty");
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfSecurity.Encrypt(options);
مثال على الاستخدام:
يوضح المثال كيفية فك تشفير مستند PDF.
// Create DecryptOptions object to set instructions
var options = new DecryptOptions("123456");
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfSecurity.Decrypt(options);
مثال على الاستخدام:
يوضح المثال كيفية توقيع مستند PDF.
// Create SignOptions object to set instructions
var options = new SignOptions("path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfSecurity.Sign(options);
مثال على الاستخدام:
يوضح المثال كيفية توقيع مستند PDF مع Timestamp.
// Create SignOptions object to set instructions
var options = new SignOptions("path_to_your_pfx_file.pfx", "password_for_your_pfx_file");
options.TimestampOptions = new TimestampOptions("server_url");
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfSecurity.Sign(options);
دمج مكوّن PdfChatGpt مع PdfManager
- Class PdfChatGpt: سيتم حذفه قريبًا، استخدم PdfManager.
- Class PdfChatGptRequestOptions: تم إعادة تسميتها إلى Class ChatGptRequestOptions.
خيارات جديدة للعمل مع ChatGpt
- Class ChatCompletion: يسمح بالتحقق من نتائج الطلب.
- Class Choice: يسمح بالتحقق من نتائج الطلب.
- Class Usage: يسمح بالتحقق من نتائج الطلب.
- Class ChatGptConsts: يسمح باستخدام إعدادات إضافية مثل ModelName، API URL وغيرها.
مثال على الاستخدام:
يوضح المثال كيفية استخدام ChatGpt بإضافة رسائل إلى الطلب.
var options = new ChatGptRequestOptions();
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
options.ApiKey = "Your API key."; // You need to provide the key to access the API.
options.MaxTokens = 1000; // The maximum number of tokens to generate in the chat completion.
// Add the request messages.
options.Messages.Add(new Message
{
Content = "You are a helpful assistant.",
Role = Role.System
});
options.Messages.Add(new Message
{
Content = "What is the biggest pizza diameter ever made?",
Role = Role.User
});
// Process the request.
var result = await PdfManager.CreatePdfByChatGptRequestAsync(options);
var fileResultPath = result.ResultCollection[0].Data;
var chatCompletionObject = result.ResultCollection[1].Data as ChatCompletion; // The ChatGPT API chat completion object.
التحسينات
- PDF إلى Image - تحسين أداء التحويل
- PDF إلى TIFF - تحسين سرعة التحويل
- PDF إلى Doc - تحسين الأداء
إصلاح الأخطاء
- تم إصلاح مشكلة تنسيق HTML إلى PDF في الملف الناتج
- تم إصلاح مشكلة الأداء في تحويل PDF إلى TIFF
- تم إصلاح مشكلة CSS الخارجية في تحويل HTML إلى PDF التي لم تُطبق على ملف PDF المُنتج
v25.10
- Class PdfExtractor: يحتوي على جميع وظائف الإضافات: TextExtractor، ImageExtractor، FormExporter.
- Class TextExtractor: سيتم حذفه قريبًا، استخدم PdfExtractor.
- Class ImageExtractor: سيتم حذفه قريبًا، استخدم PdfExtractor.
- Class FormExporter: سيتم حذفه قريبًا، استخدم PdfExtractor.
- Class TextExtractorOptions: أعيد تسميتها إلى Class ExtractTextOptions.
- Class ImageExtractorOptions: أعيد تسميتها إلى Class ExtractImagesOptions.
- Class FormExportToDsvOptions: أعيد تسميتها إلى Class ExtractFormDataToDsvOptions.
- راجع The New Plugin Architecture.
مثال على الاستخدام:
يوضح المثال كيفية استخراج محتوى النص من مستند PDF.
// Create ExtractTextOptions object to set instructions
var options = new ExtractTextOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Perform the process
var results = PdfExtractor.ExtractText(options);
// Get the extracted text from the ResultContainer object
var textExtracted = results.ResultCollection[0].ToString();
مثال على الاستخدام:
يوضح المثال كيفية استخراج محتوى النص من مستند PDF مع TextFormattingMode.
// Create ExtractTextOptions object to set TextFormattingMode
var options = new ExtractTextOptions(TextFormattingMode.Pure);
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Perform the process
var results = PdfExtractor.ExtractText(options);
// Get the extracted text from the ResultContainer object
var textExtracted = results.ResultCollection[0].ToString();
مثال على الاستخدام:
يوضح المثال كيفية استخراج الصور من مستند PDF.
// Create ExtractImagesOptions to set instructions
var options = new ExtractImagesOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// Perform the process
var results = PdfExtractor.ExtractImages(options);
// Get path to image result
var imageExtracted = results.ResultCollection[0].ToFile();
مثال على الاستخدام:
يوضح المثال كيفية تصدير قيم النموذج إلى ملف CSV.
// Create ExtractFormDataToDsvOptions object to set instructions
var options = new ExtractFormDataToDsvOptions(',', true);
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// Perform the process
PdfExtractor.ExtractFormData(options);
المكوّن الإضافي الجديد PDF Manager
- Class PdfManager: يحتوي على جميع وظائف الإضافات: Merger، Optimizer، Splitter، TableGenerator، TocGenerator.
- Class Merger: سيتم حذفه قريبًا.
- Class Optimizer: سيتم حذفه قريبًا، استخدم PdfManager.
- Class Splitter: سيتم حذفه قريبًا، استخدم PdfManager.
- Class TableGenerator: سيتم حذفه قريبًا، استخدم PdfManager.
- Class TocGenerator: سيتم حذفه قريبًا، استخدم PdfManager.
- راجع The New Plugin Architecture.
مثال على الاستخدام:
يوضح المثال كيفية دمج مستندين PDF.
// Create MergeOptions object to set instructions
var options = new MergeOptions();
// Add input file paths
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfManager.Merge(options);
مثال على الاستخدام:
يوضح المثال كيفية تقسيم مستند PDF.
// Create SplitOptions object to set instructions
var options = new SplitOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file paths
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// Perform the process
PdfManager.Split(options);
مثال على الاستخدام:
يوضح المثال كيفية تحسين مستند PDF.
// Create OptimizeOptions object to set instructions
var options = new OptimizeOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfManager.Optimize(options);
مثال على الاستخدام:
يوضح المثال كيفية تدوير مستند PDF.
// Create RotateOptions object to set instructions
var options = new RotateOptions();
// Set new Rotation
options.Rotation = Rotation.On90;
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfManager.Rotate(options);
مثال على الاستخدام:
يوضح المثال كيفية تغيير حجم مستند PDF.
// Create ResizeOptions object to set instructions
var options = new ResizeOptions();
// Set new PageSize
options.PageSize = PageSize.A3;
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfManager.Resize(options);
مثال على الاستخدام:
يوضح المثال كيفية ضغط مستند PDF.
// Create CompressOptions object to set instructions
var options = new CompressOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfManager.Compress(options);
مثال على الاستخدام:
يوضح المثال كيفية إضافة جدول إلى ملف PDF.
// Configure table options
var options = new TableOptions();
options.InsertPageBefore(1)
.AddTable()
.AddRow()
.AddCell().AddParagraph("Name")
.AddCell().AddParagraph("Age")
.AddRow()
.AddCell().AddParagraph("Bob")
.AddCell().AddParagraph("12")
.AddRow()
.AddCell().AddParagraph("Sam")
.AddCell().AddParagraph("20")
.AddRow()
.AddCell().AddParagraph("Sandy")
.AddCell().AddParagraph("26")
.AddRow()
.AddCell().AddParagraph("Tom")
.AddCell().AddParagraph("12")
.AddRow()
.AddCell().AddParagraph("Jim")
.AddCell().AddParagraph("27");
// Add input file path
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// Perform the process
PdfManager.AddTable(options);
مثال على الاستخدام:
يوضح المثال كيفية إضافة فهرس (Table of Contents) إلى ملف PDF.
// Create TocOptions object to set instructions
var options = new TocOptions();
// Set the Title
options.Title = "My Table of Contents";
// Design Headings
options.Headings.Add(new TocHeading("Introduction", 2));
options.Headings.Add(new TocHeading("Chapter I", 3));
options.Headings.Add(new TocHeading("Chapter II", 4));
options.Headings.Add(new TocHeading("Chapter III", 5));
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfManager.AddTableOfContents(options);
مثال على الاستخدام:
يوضح المثال كيفية إضافة فهرس إلى ملف PDF مع إنشاء إشارات مرجعية (bookmarks).
// Create TocOptions object to set instructions
var options = new TocOptions();
// Set the Title
options.Title = "My Table of Contents";
// Generate links in bookmarks
options.GenerateBookmarks = true;
// Design Headings
options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
options.Headings.Add(new TocHeading("Chapter I", 3, true, 1));
options.Headings.Add(new TicHeading("Chapter II", 4, true, 1));
options.Headings.Add(new TocHeading("Example A", 4, true, 2));
options.Headings.Add(new TocHeading("Example B", 4, true, 2));
options.Headings.Add(new TocHeading("Example C", 4, true, 2));
options.Headings.Add(new TocHeading("Example D", 4, true, 2));
options.Headings.Add(new TocHeading("Chapter III", 5, true, 1));
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
PdfManager.AddTableOfContents(options);
مثال على الاستخدام:
يوضح المثال كيفية إضافة فهرس إلى ملف PDF وحفظه كتيار (stream).
// Create TocOptions object to set instructions
var options = new TocOptions();
// Set the Title
options.Title = "My Table of Contents";
// Design Headings
options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output stream
var outputStream = new MemoryStream();
options.AddOutput(new StreamDataSource(outputStream));
options.CloseOutputStreams = false;
// Perform the process
PdfManager.AddTableOfContents(options);
تحسين قابلية الاستخدام لـ TableGenerator
- Class TableGenerator: ثابت ولا يتطلب استخدام مُنشئ.
- Class TableGenerator: تم وضع علامة Obsolete عليه. استخدم PdfManager بدلاً منه.
تحسين قابلية الاستخدام لـ PdfChatGpt
- Class PdfChatGpt: ثابت ولا يتطلب استخدام مُنشئ.
- Class PdfChatGptRequestOptions: تمت إضافة خاصية
CancellationToken (نُقلت من PdfChatGpt).
مثال على الاستخدام:
يوضح المثال كيفية استخدام إضافة PdfChatGpt عن طريق إضافة رسائل إلى الطلب.
var options = new PdfChatGptRequestOptions();
options.AddOutput(new FileDataSource("PdfChatGPT_output.pdf")); // Add the output file path.
options.ApiKey = "Your API key."; // You need to provide the key to access the API.
options.MaxTokens = 1000; // The maximum number of tokens to generate in the chat completion.
// for cancel
// var cancelTokenSource = new CancellationTokenSource();
// var cToken = cancelTokenSource.Token;
// options.CancellationToken = cToken;
// Add the request messages.
options.Messages.Add(new Message
{
Content = "You are a helpful assistant.",
Role = Role.System
});
options.Messages.Add(new Message
{
Content = "What is the biggest pizza diameter ever made?",
Role = Role.User
});
// Process the request.
await PdfChatGpt.ProcessAsync(options);
الأخطاء التي تم إصلاحها
- تم إصلاح مشكلة ميتا البيانات في تحويل HTML إلى PDF
- تم إصلاح مشاكل تنسيق النص والصور المتقيسة في تحويل PDF إلى PDF/A_3b
- تم إصلاح تقارير خطأ عند طباعة PDF/A الناتج من تحويل PDF إلى PDFA
- تم إصلاح مشكلة وجود خلفية في الصورة الناتجة من تحويل PDF إلى HTML
- تم إصلاح ظهور بعض الأحرف الصينية كصناديق في تحويل HTML إلى PDF
- تم إصلاح عدم احترام الخط المخصص المشفر بـ Base64 في تحويل HTML إلى PDF
- تم إصلاح عدم تطبيق أنماط CSS لحقل النموذج في تحويل HTML إلى PDF
- تم إصلاح عدم رسم المخطط بشكل صحيح في تحويل HTML إلى PDF
- تم إصلاح عدم عرض الأحرف الخاصة في تحويل HTML إلى PDF
v25.9
تحسين قابلية الاستخدام لـ DocConverter وإضافة وضع إضافي
- Class DocConverter: ثابت ولا يتطلب استخدام مُنشئ.
- Class PdfToDocOptions: تم إضافة الخاصية “Mode” التي تتيح لك تخصيص عملية التحويل.
- Enum DocConversionMode: يتيح لك تخصيص عملية التحويل من PDF إلى DOC. القيم:
- TextBox: هذا الوضع سريع ومناسب للحفاظ إلى حد كبير على الشكل الأصلي لملف الـ PDF، لكن قد تكون قابلية تحرير المستند الناتج محدودة. كل كتلة نصية مجمعة بصريًا في ملف الـ PDF الأصلي تُحول إلى مربع نص في المستند الناتج.
- Flow: وضع التعرف الكامل، حيث يقوم المحرك بتجميع وتحليل متعدد المستويات لاستعادة نية مؤلف المستند الأصلي وإنتاج مستند قابل للتحرير إلى أقصى حد.
مثال على الاستخدام:
// المثال يوضح كيف يتم تحويل مستند PDF إلى صيغة Doc.
// إنشاء كائن PdfToDocOptions لتحديد التعليمات
var options = new PdfToDocOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_file.doc"));
// تنفيذ العملية
DocConverter.Process(options);
مثال على الاستخدام (مع تحديد الوضع Mode):
// المثال يوضح كيف يتم تحويل مستند PDF إلى صيغة Doc مع تحديد الوضع Mode.
// إنشاء كائن PdfToDocOptions لتحديد التعليمات
var options = new PdfToDocOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_file.doc"));
// تعيين الوضع
options.Mode = DocConversionMode.Flow;
// تنفيذ العملية
DocConverter.Process(options);
تحسين قابلية الاستخدام لـ PdfAConverter
Class PdfAConverter: ثابت ولا يتطلب استخدام مُنشئ.
مثال على الاستخدام:
// المثال يوضح كيف يتم تحويل مستند PDF إلى صيغة PDF/A (PDF/A-3b في هذه الحالة):
// إنشاء كلاس الخيارات لتكوين عملية التحويل
var options = new PdfAConvertOptions
{
PdfAVersion = PdfAStandardVersion.PDF_A_3B
};
// إضافة ملف المصدر
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf")); // استبدل بمسار ملفك الفعلي
// إضافة المسار لحفظ الملف المحول
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// تشغيل التحويل
PdfAConverter.Process(options);
مثال على الاستخدام (التحقق من التوافقية):
// المثال يوضح كيف يتم التحقق من التوافقية لمستند PDF مع صيغة PDF/A (PDF/A-1a في هذه الحالة):
// إنشاء كلاس الخيارات لتكوين عملية التحقق
var options = new PdfAValidateOptions
{
PdfAVersion = PdfAStandardVersion.PDF_A_1A
};
// إضافة ملف (أو أكثر) للتحقق
options.AddInput(new FileDataSource("path_to_your_first_pdf_file.pdf")); // استبدل بمسار ملفك الفعلي
options.AddInput(new FileDataSource("path_to_your_second_pdf_file.pdf"));
// أضف ملفات أخرى حسب الحاجة
// تشغيل عملية التحقق والحصول على النتائج
var resultContainer = PdfAConverter.Process(options);
// تحقق من الخاصية ResultCollection في resultContainer للحصول على نتائج التحقق لكل ملف:
for (var i = 0; i < resultContainer.ResultCollection.Count; i++)
{
var result = resultContainer.ResultCollection[i];
var validationResult = (PdfAValidationResult) result.Data;
var isValid = validationResult.IsValid; // نتيجة التحقق للوثيقة رقم i
}
تحسين قابلية الاستخدام لـ Timestamp
Class Timestamp: ثابت ولا يتطلب استخدام مُنشئ.
مثال على الاستخدام:
// المثال يوضح كيف يتم إضافة Timestamp إلى المستند.
// إنشاء كائن AddTimestampOptions لتحديد التعليمات
var options = new AddTimestampOptions("path_to_your_pfx_file.pfx", "password_for_your_pfx_file", "timestamp_server_url");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
Timestamp.Process(options);
توثيق محدث
تم تحديث الأمثلة، وإضافة أمثلة إضافية:
- معلومات حول الترخيص والتقييم
- صفحات المنتج
- مولد جداول PDF
- مولد فهرس محتويات PDF (PDF TOC Generator)
- أداة إضافة Timestamp لملفات PDF
- محول PDF/A
- مستخرج صور PDF
- مستخرج نصوص PDF
- محول PDF إلى XLS
- محول PDF إلى HTML
إصلاح الأخطاء
- تم إصلاح المشاكل مع التحويل من HTML إلى PDF
- تم إصلاح المشاكل مع التحويل من PDF إلى PDF/A-2B
- تحسين التحويل من PDF إلى JPEG: بعض أحرف النص كانت تظهر كمربعات
- تم إصلاح عرض PDF إلى TIFF
- تم إصلاح الاستثناءات غير المتوقعة عند التحويل من PDF إلى JPEG
v25.8
تحسين قابلية استخدام JpegConverter
الفئة JpegConverter: ثابتة ولا تتطلب استخدام منشئ.
مثال على الاستخدام:
// The example demonstrates how to convert PDF document into JPEG format.
// Create PdfToJpegOptions object to set instructions
var options = new PdfToJpegOptions();
// Add input File path
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Perform the process
JpegConverter.Process(options);
تحسين قابلية استخدام PngConverter
الفئة PngConverter: ثابتة ولا تتطلب استخدام منشئ.
مثال على الاستخدام:
// The example demonstrates how to convert PDF document into PNG format.
// Create PdfToPngOptions object to set instructions
var options = new PdfToPngOptions();
// Add input File path
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Perform the process
PngConverter.Process(options);
تحسين قابلية استخدام XlsConverter
- الفئة XlsConverter: ثابتة ولا تتطلب استخدام منشئ.
- الفئة XlsConverter: تم تصحيح الوصف.
مثال على الاستخدام:
// The example demonstrates how to convert PDF to XLSX document.
// Create PdfToXlsOptions object to set instructions
var options = new PdfToXlsOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
/* Set output file path */
options.AddOutput(new FileDataSource("path_to_result_xlsx_file.xlsx"));
// Perform the process
XlsConverter.Process(options);
تحسين قابلية استخدام Signature
- الفئة Signature: ثابتة ولا تتطلب استخدام منشئ.
- الفئة Signature: تم تصحيح الوصف.
- الفئة Signature: تم إزالة الواجهة IPlugin.
مثال على الاستخدام:
// The example demonstrates how to sign PDF document.
// Create SignOptions object to set instructions
var options = new SignOptions("path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
/* Set output file path */
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
Signature.Process(options);
تعديل مُنشئات PdfToHtmlOptions
تم تحسين المُنشئات والمعاملات.
تم تغيير نص علامة التقييم.
تحديث الوثائق
تم تحديث الأمثلة وإضافة أمثلة إضافية:
- محول PDF إلى JPEG
- محول PDF إلى PNG
- محول PDF إلى TIFF
- مسطح نماذج PDF
- محول HTML
- أمان PDF
- تحسين PDF
- دمج PDF
- تقسيم PDF
إصلاحات الأخطاء
- إصلاح المشكلات المتعلقة بالتعليقات التوضيحية
- إصلاح المشكلات بعد تغيير الحجم
- إصلاح تحويل أسماء الخطوط في PDF إلى PDF/A
- إصلاح PDF إلى DOCX – إضافة مساحة في الرأس، ومشكلات أخرى
- إصلاح HTML إلى PDF – خلفية PNG شفافة
- إصصلاح PDF مضغوط – تحسين العمل مع Adobe Acrobat
v25.7
تحسين قابلية الاستخدام لمستخرج النص
- Class TextExtractor: ثابت ولا يتطلب استخدام مُنشئ.
- Class TextExtractor: تم تحسين السلوك عند التشغيل في وضع التقييم. لا استثناء مع مستندات من 4 صفحات أو أكثر.
- Class TextExtractor: تم إصلاح المشكلات في طريقة Process.
- Class PdfExtractorOptions: تم إزالته.
- Class TextExtractorOptions: تم إعادة هيكله.
- Enum TextFormattingMode: أعيد تسميته وتم تحسينه.
مثال على الاستخدام:
// The example demonstrates how to extract text content of PDF document.
// Create TextExtractorOptions object to set instructions
var options = new TextExtractorOptions(TextFormattingMode.Pure);
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Perform the process
var results = TextExtractor.Process(options);
// Get the extracted text from the ResultContainer object
var textExtracted = results.ResultCollection[0].ToString();
تحسين قابلية الاستخدام لمحوّل HTML
- Class HtmlConverter: ثابت ولا يتطلب استخدام مُنشئ.
- Class HtmlConverter: تم إصلاح المشكلات في طريقة Process.
- Class HtmlConverter: تم إزالة منطق IDisposable.
- Class PdfConverterOptions: تم إزالته.
أمثلة على الاستخدام:
// The example demonstrates how to convert PDF to HTML document.
// Create PdfToHtmlOptions object to set output data type as file with embedded resources
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// Add input file path
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_output.html"));
// Perform the process
HtmlConverter.Process(options);
// The example demonstrates how to convert HTML to PDF document.
// Create HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_input.html"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// Perform the process
HtmlConverter.Process(options);
تحسين قابلية الاستخدام لمستخرج الصور
- Class ImageExtractor: ثابت ولا يتطلب استخدام مُنشئ.
مثال على الاستخدام:
// The example demonstrates how to extract images from PDF document.
// Create ImageExtractorOptions to set instructions
var options = new ImageExtractorOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// Perform the process
var results = ImageExtractor.Process(options);
// Get path to image result
var imageExtracted = results.ResultCollection[0].ToFile();
تصحيحات بسيطة
- إصلاحات داخلية.
- تم إصلاح أمثلة وتلميحات محوّل TIFF.
- تقليل مدة تحسين الصفحات.
- تم إصلاح: صورة غير صحيحة في التحويل من PDF إلى PNG.
- تم إصلاح: عدم عرض الأحرف الصينية بشكل صحيح أثناء التحويل من PDF إلى PNG.
- تحسين: الأداء أثناء التحويل من PDF إلى HTML.
v25.6
تحسين قابلية الاستخدام لمحوّل Tiff
- Class PdfToTiffOptions: إضافة معلمة إضافية للتحويل - Compression.
- Class PdfToTiffOptions: إضافة معلمة إضافية للتحويل - ColorDepth.
- Class TiffConverter ثابت ولا يتطلب استخدام مُنشئ.
- تحسين الأمثلة الرئيسية.
أمثلة الاستخدام:
// The example demonstrates how to convert PDF document into TIFF format.
// Create PdfToTiffOptions object to set instructions
var options = new PdfToTiffOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Perform the process
TiffConverter.Process(options);
// The example demonstrates how to convert PDF document into TIFF format with additional parameters.
// Create PdfToTiffOptions object to set instructions
var options = new PdfToTiffOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output Directory path
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Optional parameters
options.PageList = new List<int> { 1, 3 };
options.MultiPage = true;
options.OutputResolution = 400;
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// Perform the process
TiffConverter.Process(options);
إصلاحات طفيفة
v25.5
- Class FormExporter: يمثل المكوّن Documentize.FormExporter الذي يُستخدم لتصدير قيم النماذج في مستندات PDF إلى ملف DSV أو CSV
- Class FormExportToDsvOptions: يمثل الخيارات لتصدير قيم مستندات PDF إلى ملف DSV أو CSV باستخدام المكوّن Documentize.FormExporter.
مثال على الاستخدام:
// المثال يوضح كيفية تصدير قيم النموذج إلى ملف CSV.
// إنشاء كائن FormExportToDsvOptions لتحديد التعليمات
var options = new FormExportToDsvOptions(',', true);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// تنفيذ العملية
FormExporter.Process(options);
تحسين قابلية الاستخدام في Security
- الكلاس ثابت ولا يتطلب استخدام مُنشئ.
- تحسين الأمثلة الرئيسية.
أمثلة على الاستخدام:
// المثال يوضح كيفية تشفير مستند PDF.
// إنشاء كائن EncryptionOptions لتحديد التعليمات
var options = new EncryptionOptions("123456", "qwerty");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
Security.Process(options);
// المثال يوضح كيفية فك تشفير مستند PDF.
// إنشاء كائن DecryptionOptions لتحديد التعليمات
var options = new DecryptionOptions("123456");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
Security.Process(options);
إصلاحات طفيفة
- تحسين تلميحات الكلاس والترخيصات.
v25.4
تحسين قابلية الاستخدام لـ Optimizer
- الصنف ثابت ولا يتطلب استخدام المُنشئ.
- تحسين المثال الرئيسي.
- إضافة أمثلة إضافية.
أمثلة الاستخدام:
// The example demonstrates how to Optimize PDF document.
// Create OptimizeOptions object to set instructions
var options = new OptimizeOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
Optimizer.Process(options);
// The example demonstrates how to Rotate PDF document.
// Create RotateOptions object to set instructions
var options = new RotateOptions();
// Set new Rotation
options.Rotation = Rotation.On90;
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
Optimizer.Process(options);
// The example demonstrates how to Resize PDF document.
// Create ResizeOptions object to set instructions
var options = new ResizeOptions();
// Set new PageSize
options.PageSize = PageSize.A3;
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
Optimizer.Process(options);
// The example demonstrates how to Compress PDF document.
// Create CompressOptions object to set instructions
var options = new CompressOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
Optimizer.Process(options);
تحسين قابلية الاستخدام لـ Plugin Splitter
- الصنف ثابت ولا يتطلب استخدام المُنشئ.
- تحسين المثال الرئيسي.
أمثلة الاستخدام:
// The example demonstrates how to Split PDF document.
// Create SplitOptions object to set instructions
var options = new SplitOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file paths
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// Perform the process
Splitter.Process(options);
تحسين قابلية الاستخدام لـ Plugin Merger
- الصنف ثابت ولا يتطلب استخدام المُنشئ.
- تحسين المثال الرئيسي.
أمثلة الاستخدام:
// The example demonstrates how to Merge two PDF documents.
// Create MergeOptions object to set instructions
var options = new MergeOptions();
// Add input file paths
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
Merger.Process(options);
إصلاحات بسيطة
v25.3
- Class FormFlattener: يمثل ملحق Documentize.FormFlattener الذي يُستخدم لتسوية الحقول في مستندات PDF.
- Class FormFlattenerOptions: يمثل الخيارات لتسوية الحقول في المستند بواسطة ملحق Documentize.FormFlattener.
مثال على الاستخدام:
//The example demonstrates how to Flatten fields in PDF file.
// Create FormFlattenerOptions object to set instructions
var options = new FormFlattenerOptions();
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
//Optional parameter for skip the field with name "Surname".
options.SkipFields.Add("Surname");
// Perform the process
FormFlattener.Process(options);
//The example demonstrates how to Get Field Names from PDF file.
var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");
تصحيحات طفيفة
- تم تحسين تلميحات الفئات والأمثلة.
v25.2
تم إضافة ملحق جديد: TOC Generator
- Class TocGenerator: يمثل ملحق Documentize.TocGenerator. يُستخدم لإضافة جدول محتويات إلى مستندات PDF.
- Class TocOptions: يمثل خيارات إضافة جدول المحتويات إلى المستند باستخدام ملحق Documentize.TocGenerator.
- Class TocHeading: يمثل خيارات العناوين أو العناوين الفرعية لجدول المحتويات في المستند باستخدام ملحق Documentize.TocGenerator.
مثال على الاستخدام:
// The example demonstrates how to add Table of Contents to PDF file.
var options = new TocOptions();
// Set the Title
options.Title = "My Table of Contents";
// Generate links in bookmarks
options.GenerateBookmarks = true;
// Design Headings
options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
options.Headings.Add(new TocHeading("Chapter I", 3, true, 1));
options.Headings.Add(new TocHeading("Chapter II", 4, true, 1));
options.Headings.Add(new TocHeading("Example A", 4, true, 2));
options.Headings.Add(new TocHeading("Example B", 4, true, 2));
options.Headings.Add(new TocHeading("Example C", 4, true, 2));
options.Headings.Add(new TocHeading("Example D", 4, true, 2));
options.Headings.Add(new TocHeading("Chapter III", 5, true, 1));
// Add input file path
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Perform the process
TocGenerator.Process(options);
إصلاحات طفيفة
- تحسين التلميحات في الفئات والأمثلة.
- تحديث العلامات المائية.
- تحسين تحويل PDF إلى XSLX.
- تحسين تحويل PDF إلى PDF/A-1a.
v25.1
- تم إضافة مجموعة الإخراج إلى ImageExtractorOptions.
- تم إضافة دعم لمدخلات متعددة إلى ImageExtractorOptions.
- تم إصلاح تدفقات الإخراج المغلقة.
مثال على الاستخدام:
// create ImageExtractor object to extract images
var plugin = new ImageExtractor();
// create ImageExtractorOptions
var opt = new ImageExtractorOptions();
// add input file path
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// set output directory
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// perform extraction process
var resultContainer = plugin.Process(opt);
// get the image from the ResultContainer object
var imageExtracted = resultContainer.ResultCollection[0].ToFile();
إصلاحات طفيفة
- تحسين تلميحات الفئات والأمثلة.
- التحقق من توقيع ملف PDF.
- تحسين دعم الأحرف الصينية.
v24.12
إضافة مكوّن إضافي جديد: محول PDF إلى PNG
- Class PngConverter: يمثل مكوّن Documentize.PngConverter. يُستخدم لتحويل مستندات PDF إلى صيغة PNG.
- Class PdfToPngOptions: يمثل خيارات محول PDF إلى PNG للمكوّن Documentize.PngConverter.
مثال على الاستخدام:
// create PngConverter
var plugin = new PngConverter();
// create PdfToPngOptions object to set instructions
var opt = new PdfToPngOptions();
// add input file path
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// set output file path
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// perform the process
plugin.Process(opt);
إضافة مكوّن إضافي جديد: محول PDF إلى TIFF
- Class TiffConverter: يمثل مكوّن Documentize.TiffConverter. يُستخدم لتحويل مستندات PDF إلى صيغة TIFF.
- Class PdfToTiffOptions: يمثل خيارات محول PDF إلى TIFF للمكوّن Documentize.TiffConverter.
مثال على الاستخدام:
// create TiffConverter
var plugin = new TiffConverter();
// create PdfToTiffOptions object to set instructions
var opt = new PdfToTiffOptions();
// add input file path
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// set output file path
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// perform the process
plugin.Process(opt);
إضافة مكوّن إضافي جديد: مولّد جداول PDF
- Class TableGenerator: يمثل مكوّن Documentize.TableGenerator. يُستخدم لإضافة جدول إلى مستند PDF.
- Class TableBuilder: يمثل مُنشئ الجدول في صفحة PDF.
- Class TableRowBuilder: يمثل مُنشئ صف الجدول.
- Class TableCellBuilder: يمثل مُنشئ خلية الجدول.
مثال على الاستخدام:
// create TableGenerator
var plugin = new TableGenerator();
// create TableOptions object to set instructions
TableOptions opt = new TableOptions().InsertPageBefore(1)
.AddTable()
.AddRow()
.AddCell().AddParagraph("Name")
.AddCell().AddParagraph("Age")
.AddRow()
.AddCell().AddParagraph("Bob")
.AddCell().AddParagraph("12")
.AddRow()
.AddCell().AddParagraph("Sam")
.AddCell().AddParagraph("20")
.AddRow()
.AddCell().AddParagraph("Sandy")
.AddCell().AddParagraph("26")
.AddRow()
.AddCell().AddParagraph("Tom")
.AddCell().AddParagraph("12")
.AddRow()
.AddCell().AddParagraph("Jim")
.AddCell().AddParagraph("27");
// add input file path
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
/* set output file path */
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// perform the process
plugin.Process(opt);
إعادة تسمية الفئة PdfDoc إلى DocConverter
- Class DocConverter: يمثل مكوّن Documentize.DocConverter. يُستخدم لتحويل مستندات PDF إلى صيغة DOC/DOCX.
مثال على الاستخدام:
// create DocConverter
var plugin = new DocConverter();
// create PdfToDocOptions object to set instructions
var opt = new PdfToDocOptions();
// add input file path
opt.AddInput(new FileDataSource(inputPath));
// set output file path
opt.AddOutput(new FileDataSource(outputPath));
// perform the process
plugin.Process(opt);
v24.11
تم إضافة مكوّن إضافي جديد: محوّل PDF إلى JPEG
- الغرض: صُممت الفئة
JpegConverter لتحويل مستندات PDF إلى تنسيق JPEG، مما يسهل على المستخدمين التعامل مع الصور المستخرجة من ملفات PDF ومشاركتها. - البناء:
JpegConverter(): يinitializes نسخة جديدة من محوّل JPEG.
مثال على الاستخدام:
var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);
- الطريقة:
Process(PdfToJpegOptions options): يبدأ عملية تحويل JPEG باستخدام الخيارات المحددة.
تم إضافة الفئة DirectoryDataSource
- الغرض: تسمح الفئة
DirectoryDataSource للمستخدمين بإدارة بيانات الدليل للعمليات الخاصة بالتحميل والحفظ داخل المكوّنات الإضافية. - البناء:
DirectoryDataSource(string path): يinitializes كائن بيانات دليل جديد باستخدام المسار المحدد.
مثال على الاستخدام:
var directorySource = new DirectoryDataSource("path_to_your_directory");
- الخصائص:
DataType: يسترجع نوع مصدر البيانات.Path: يحصل على مسار الدليل الحالي للبيانات.
تم إضافة الفئة PdfToJpegOptions
- الغرض: تحتوي هذه الفئة على خيارات لتكوين عملية تحويل JPEG، مما يتيح للمستخدمين تحديد الدقة، وقائمة الصفحات، وجودة الصورة.
- البناء:
PdfToJpegOptions(): يinitializes نسخة جديدة من الخيارات لمحوّل JPEG.
الخصائص:
OutputResolution: يحدد دقة صور JPEG الناتجة.PageList: قائمة الصفحات التي سيتم تحويلها من ملف PDF.Quality: يضبط جودة إخراج JPEG.
v24.10
تم إضافة مكوّن إضافي جديد: محول PDF/A
- تم تقديم ميزة تحويل PDF/A جديدة، تتيح للمستخدمين تحويل ملفات PDF القياسية بسهولة إلى مستندات متوافقة مع PDF/A.
مثال على الاستخدام:
var options = new PdfAConvertOptions
{
PdfAVersion = PdfAStandardVersion.PDF_A_3B
};
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
var plugin = new PdfAConverter();
plugin.Process(options);
إصلاحات الأخطاء
- تم إصلاح المشكلات المتعلقة بفئة
FileResult التي أدت إلى مسارات إخراج غير صحيحة. - تم حل الأخطاء الطفيفة التي تؤثر على
HtmlConverter عند التعامل مع ملفات كبيرة.
التحسينات
- تحسين أداء
PdfExtractor و ImageExtractor لأوقات معالجة أسرع. - تم تحديث فئة
RotateOptions لدعم زوايا دوران إضافية.
v24.9
تم الإصدار