ما الجديد الأقسام الفرعية
v26.5
ميزة جديدة: تنظيف لأمان PDF
- تنظيف البيانات المخفية من مستند PDF، مع ضمان إزالة أو تحويل المعلومات الحساسة أو غير الضرورية مثل البيانات التعريفية، المرفقات، التعليقات التوضيحية، جافا سكريبت، النماذج، الطبقات، فهرس البحث أو المحتوى الخاص.
- Class PdfSecurity: أضيفت طريقة Sanitize لتنقية مستند PDF.
- Class SanitizeOptions: تمثل خيارات التكوين لتنظيف البيانات المخفية داخل مستند لفئة PdfSecurity.
- Property Input: الحصول على بيانات الإدخال أو تعيينها.
- Property Output: الحصول على بيانات الإخراج أو تعيينها.
- Property ConvertPagesToImages: الحصول على خيار تحويل الصفحات إلى صور أو تعيينه.
- Property ImageDpi: الحصول على خيار تحديد دقة الصور أثناء تحويل الصفحات إلى صور أو تعيينه.
- 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"));
- تمثل الخيارات الأساسية للعمليات التي تتضمن بيانات إدخال واحدة وبيانات إخراج واحدة.
- Based on 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 إلى PNG وقتًا مفرطًا
- تم إصلاح صورة الإخراج غير الصحيحة في تحويل PDF إلى PNG
- تم إصلاح ظهور خطوط مظلمة في صورة الإخراج عند تحويل PDF إلى PNG
- تم إصلاح عدم القدرة على التحقق من امتثال المستند لـ PDF/A_1b
v26.4
- Method PdfExtractor.Extract: لا يرمِ استثناءً إذا لم يتم العثور على تواريخ الإنشاء والتعديل في المستند المدخل.
- Property PdfProperties.Created: تُعيد null إذا لم يتم العثور على القيمة في المستند المدخل. تم تغيير نوع البيانات من “DateTime” إلى “DateTime?”.
- Property 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.
- فئات الخيارات الآن أسهل في الاستخدام.
- تم تحديث وتعليق تعليقات xml.
- تم تحديث جميع الأمثلة الخاصة بالإدخال والإخراج.
مثال على الاستخدام:
المثال يوضح كيفية استخدام FileData في الإدخال والإخراج.
// 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.
- فئات الخيارات الآن أسهل في الاستخدام.
- تم تحديث وتعليق تعليقات xml.
- تم تحديث جميع الأمثلة الخاصة بالإدخال والإخراج.
مثال على الاستخدام:
المثال يوضح كيفية استخدام StreamData في الإخراج.
// 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.
- فئات الخيارات الآن أسهل في الاستخدام.
- تم تحديث جميع الأمثلة الخاصة بالإدخال والإخراج.
مثال على الاستخدام:
المثال يوضح كيفية تصدير قيم النماذج إلى ملف 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/
إصلاح المشكلات
- تم إصلاح مشكلة حيث كان تحويل Image إلى 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
- استخراج خصائص 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
- مشكلة في محاذاة الحقول الشكلية رأسياً
- تم إصلاح مشكلة عرض النص الياباني في FormField
- مشكلة تنسيق الجداول في تحويل HTML إلى PDF
- تحسين حجم PDF قبل التحويل إلى PDF/A يؤدي إلى إخراج فاسد
- تحويل PDF إلى DOC – ظهور الجدول بشكل غير صالح
- تحويل PDF إلى Excel – مشاكل تنسيق ملف الإخراج
- تحويل PDF إلى HTML – استثناء ArgumentException أثناء التحويل
- تحويل 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
- 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.
// إنشاء كائن PdfToDocOptions لتحديد التعليمات
var options = new PdfToDocOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_file.doc"));
// تنفيذ العملية
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل PDF إلى مستند XLSX.
// إنشاء كائن PdfToXlsOptions لتحديد التعليمات
var options = new PdfToXlsOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_xlsx_file.xlsx"));
// تنفيذ العملية
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل PDF إلى مستند HTML.
// إنشاء كائن PdfToHtmlOptions لتعيين نوع البيانات الناتجة كملف يحتوي على موارد مدمجة
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.html"));
// تنفيذ العملية
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل HTML إلى مستند PDF.
// إنشاء HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.html"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// تنفيذ العملية
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى تنسيق JPEG.
// إنشاء كائن PdfToJpegOptions لتحديد التعليمات
var options = new PdfToJpegOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تعيين مسار الدليل الناتج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// تنفيذ العملية
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى تنسيق PNG.
// إنشاء كائن PdfToPngOptions لتحديد التعليمات
var options = new PdfToPngOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تعيين مسار الدليل الناتج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// تنفيذ العملية
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى تنسيق TIFF.
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الدليل الناتج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// تنفيذ العملية
PdfConverter.Convert(options);
مثال على الاستخدام:
يوضح المثال كيفية تحويل مستند PDF إلى تنسيق PDF/A (PDF/A-3b في هذه الحالة):
// إنشاء فئة الخيارات لإعداد عملية التحويل
var options = new PdfToPdfAOptions
{
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"));
// تشغيل التحويل
PdfConverter.Convert(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 = PdfConverter.Validate(options);
// تحقق من خاصية resultContainer.ResultCollection للحصول على نتائج التحقق لكل ملف:
for (var i = 0; i < resultContainer.ResultCollection.Count; i++)
{
var result = resultContainer.ResultCollection[i];
var validationResult = (PdfAValidationResult) result.Data;
var isValid = validationResult.IsValid; // نتيجة التحقق للوثيقة رقم i
}
إضافة جديدة: أمان PDF
- 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.
// إنشاء كائن EncryptOptions لتحديد التعليمات
var options = new EncryptOptions("123456", "qwerty");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfSecurity.Encrypt(options);
مثال على الاستخدام:
يوضح المثال كيفية فك تشفير مستند PDF.
// إنشاء كائن DecryptOptions لتحديد التعليمات
var options = new DecryptOptions("123456");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfSecurity.Decrypt(options);
مثال على الاستخدام:
يوضح المثال كيفية توقيع مستند PDF.
// إنشاء كائن SignOptions لتحديد التعليمات
var options = new SignOptions("path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfSecurity.Sign(options);
مثال على الاستخدام:
يوضح المثال كيفية توقيع مستند PDF مع توقيت.
// إنشاء كائن SignOptions لتحديد التعليمات
var options = new SignOptions("path_to_your_pfx_file.pfx", "password_for_your_pfx_file");
options.TimestampOptions = new TimestampOptions("server_url");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
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();
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
options.ApiKey = "Your API key."; // تحتاج إلى تقديم المفتاح للوصول إلى واجهة برمجة التطبيقات.
options.MaxTokens = 1000; // الحد الأقصى لعدد الرموز لإنتاجها في إكمال الدردشة.
// إضافة رسائل الطلب.
options.Messages.Add(new Message
{
Content = "أنت مساعد مفيد.",
Role = Role.System
});
options.Messages.Add(new Message
{
Content = "ما هو أكبر قطر بيتزا تم صنعه على الإطلاق؟",
Role = Role.User
});
// معالجة الطلب.
var result = await PdfManager.CreatePdfByChatGptRequestAsync(options);
var fileResultPath = result.ResultCollection[0].Data;
var chatCompletionObject = result.ResultCollection[1].Data as ChatCompletion; // كائن إكمال الدردشة لواجهة برمجة تطبيقات ChatGPT.
تحسينات
- PDF إلى صورة - تحسين أداء التحويل
- PDF إلى TIFF - تحسين سرعة التحويل
- PDF إلى Doc - تحسين الأداء
إصلاح الأخطاء
- إصلاح تحويل HTML إلى PDF - مشكلات التنسيق في الملف الناتج
- إصلاح مشكلة الأداء في تحويل PDF إلى TIFF
- إصلاح تحويل HTML إلى PDF - ملف CSS كموارد خارجية لا ينطبق على ملف 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.
// إنشاء كائن ExtractTextOptions لتعيين التعليمات
var options = new ExtractTextOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تنفيذ العملية
var results = PdfExtractor.ExtractText(options);
// الحصول على النص المستخرج من كائن ResultContainer
var textExtracted = results.ResultCollection[0].ToString();
مثال على الاستخدام:
يوضح المثال كيفية استخراج محتوى النص من وثيقة PDF باستخدام TextFormattingMode.
// إنشاء كائن ExtractTextOptions لتعيين TextFormattingMode
var options = new ExtractTextOptions(TextFormattingMode.Pure);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تنفيذ العملية
var results = PdfExtractor.ExtractText(options);
// الحصول على النص المستخرج من كائن ResultContainer
var textExtracted = results.ResultCollection[0].ToString();
مثال على الاستخدام:
يوضح المثال كيفية استخراج الصور من وثيقة PDF.
// إنشاء ExtractImagesOptions لتعيين التعليمات
var options = new ExtractImagesOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
var results = PdfExtractor.ExtractImages(options);
// الحصول على مسار نتيجة الصورة
var imageExtracted = results.ResultCollection[0].ToFile();
مثال على الاستخدام:
يوضح المثال كيفية تصدير قيم النموذج إلى ملف CSV.
// إنشاء كائن ExtractFormDataToDsvOptions لتعيين التعليمات
var options = new ExtractFormDataToDsvOptions(',', true);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// تنفيذ العملية
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.
// إنشاء كائن MergeOptions لتعيين التعليمات
var options = new MergeOptions();
// إضافة مسارات ملفات الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfManager.Merge(options);
مثال على الاستخدام:
يوضح المثال كيفية تقسيم وثيقة PDF.
// إنشاء كائن SplitOptions لتعيين التعليمات
var options = new SplitOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسارات ملفات الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// تنفيذ العملية
PdfManager.Split(options);
مثال على الاستخدام:
يوضح المثال كيفية تحسين وثيقة PDF.
// إنشاء كائن OptimizeOptions لتعيين التعليمات
var options = new OptimizeOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfManager.Optimize(options);
مثال على الاستخدام:
يوضح المثال كيفية تدوير وثيقة PDF.
// إنشاء كائن RotateOptions لتعيين التعليمات
var options = new RotateOptions();
// تعيين التدوير الجديد
options.Rotation = Rotation.On90;
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfManager.Rotate(options);
مثال على الاستخدام:
يوضح المثال كيفية تغيير حجم وثيقة PDF.
// إنشاء كائن ResizeOptions لتعيين التعليمات
var options = new ResizeOptions();
// تعيين حجم الصفحة الجديد
options.PageSize = PageSize.A3;
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfManager.Resize(options);
مثال على الاستخدام:
يوضح المثال كيفية ضغط وثيقة PDF.
// إنشاء كائن CompressOptions لتعيين التعليمات
var options = new CompressOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfManager.Compress(options);
مثال على الاستخدام:
يوضح المثال كيفية إضافة جدول إلى ملف PDF.
// تكوين خيارات الجدول
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");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// تنفيذ العملية
PdfManager.AddTable(options);
مثال على الاستخدام:
يوضح المثال كيفية إضافة جدول محتويات إلى ملف PDF.
// إنشاء كائن TocOptions لتعيين التعليمات
var options = new TocOptions();
// تعيين العنوان
options.Title = "My Table of Contents";
// تصميم العناوين
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));
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfManager.AddTableOfContents(options);
مثال على الاستخدام:
يوضح المثال كيفية إضافة جدول محتويات إلى ملف PDF مع إنشاء إشارات مرجعية.
// إنشاء كائن TocOptions لتعيين التعليمات
var options = new TocOptions();
// تعيين العنوان
options.Title = "My Table of Contents";
// إنشاء روابط في الإشارات المرجعية
options.GenerateBookmarks = true;
// تصميم العناوين
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));
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
PdfManager.AddTableOfContents(options);
مثال على الاستخدام:
يوضح المثال كيفية إضافة جدول محتويات إلى ملف PDF وحفظه كتيار.
// إنشاء كائن TocOptions لتعيين التعليمات
var options = new TocOptions();
// تعيين العنوان
options.Title = "My Table of Contents";
// تصميم العناوين
options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين تيار الإخراج
var outputStream = new MemoryStream();
options.AddOutput(new StreamDataSource(outputStream));
options.CloseOutputStreams = false;
// تنفيذ العملية
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")); // إضافة مسار ملف الإخراج.
options.ApiKey = "Your API key."; // تحتاج إلى توفير المفتاح للوصول إلى الـ API.
options.MaxTokens = 1000; // أقصى عدد من الرموز لتوليد في استكمال الدردشة.
// للإلغاء
// var cancelTokenSource = new CancellationTokenSource();
// var cToken = cancelTokenSource.Token;
// options.CancellationToken = cToken;
// إضافة رسائل الطلب.
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
});
// معالجة الطلب.
await PdfChatGpt.ProcessAsync(options);
إصلاح الأخطاء
- إصلاح بيانات التعريف لتحويل html إلى pdf
- إصلاح مشاكل تنسيق النص والصور التي تscaled عند تحويل PDF إلى PDF/A_3b
- إصلاح تقارير الخطأ على الطباعة الناتجة من PDF إلى PDFA
- إصلاح تحويل PDF إلى HTML: تحتوي الصورة الناتجة على الخلفية
- إصلاح تحويل HTML إلى PDF: تظهر بعض الأحرف الصينية كصندوق
- إصلاح تحويل HTML إلى PDF: لا يتم احترام الخط المخصص في Base64
- إصلاح تحويل HTML إلى PDF: لا يتم تطبيق css على حقول النموذج
- إصلاح تحويل 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);
مثال للاستخدام:
// المثال يوضح كيفية تحويل مستند 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"));
// تعيين Mode
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);
// تحقق من خاصية resultContainer.ResultCollection للحصول على نتائج التحليل لكل ملف:
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
- إضافي 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
Class JpegConverter: ثابت ولا يتطلب استخدام مُنشئ.
مثال على الاستخدام:
// المثال يوضح كيفية تحويل مستند PDF إلى تنسيق JPEG.
// إنشاء كائن PdfToJpegOptions لتحديد التعليمات
var options = new PdfToJpegOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تعيين مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// تنفيذ العملية
JpegConverter.Process(options);
تحسين قابلية استخدام PngConverter
Class PngConverter: ثابت ولا يتطلب استخدام مُنشئ.
مثال على الاستخدام:
// المثال يوضح كيفية تحويل مستند PDF إلى تنسيق PNG.
// إنشاء كائن PdfToPngOptions لتحديد التعليمات
var options = new PdfToPngOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تعيين مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// تنفيذ العملية
PngConverter.Process(options);
تحسين قابلية استخدام XlsConverter
- Class XlsConverter: ثابت ولا يتطلب استخدام مُنشئ.
- Class XlsConverter: تم تصحيح الوصف.
مثال على الاستخدام:
// المثال يوضح كيفية تحويل PDF إلى مستند XLSX.
// إنشاء كائن PdfToXlsOptions لتحديد التعليمات
var options = new PdfToXlsOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_xlsx_file.xlsx"));
// تنفيذ العملية
XlsConverter.Process(options);
تحسين قابلية استخدام Signature
- Class Signature: ثابت ولا يتطلب استخدام مُنشئ.
- Class Signature: تم تصحيح الوصف.
- Class Signature: تمت إزالة الواجهة IPlugin.
مثال على الاستخدام:
// المثال يوضح كيفية توقيع مستند PDF.
// إنشاء كائن SignOptions لتحديد التعليمات
var options = new SignOptions("path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
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: تمت إعادة تسميته وتحسينه.
مثال على الاستخدام:
// المثال يوضح كيفية استخراج محتوى النص من مستند PDF.
// إنشاء كائن TextExtractorOptions لتحديد التعليمات
var options = new TextExtractorOptions(TextFormattingMode.Pure);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تنفيذ العملية
var results = TextExtractor.Process(options);
// الحصول على النص المستخرج من كائن ResultContainer
var textExtracted = results.ResultCollection[0].ToString();
تحسين قابلية استخدام محوّل HTML
- Class HtmlConverter: ثابت ولا يتطلب استخدام منشئ.
- Class HtmlConverter: تم إصلاح مشكلات في طريقة Process.
- Class HtmlConverter: تمت إزالة منطق IDisposable.
- Class PdfConverterOptions: تمت إزالته.
أمثلة على الاستخدام:
// المثال يوضح كيفية تحويل PDF إلى مستند HTML.
// إنشاء كائن PdfToHtmlOptions لتحديد نوع بيانات الإخراج كملف مع موارد مضمنة
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.html"));
// تنفيذ العملية
HtmlConverter.Process(options);
// المثال يوضح كيفية تحويل HTML إلى مستند PDF.
// إنشاء HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.html"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// تنفيذ العملية
HtmlConverter.Process(options);
تحسين قابلية استخدام مستخرج الصور
- Class ImageExtractor: ثابت ولا يتطلب استخدام منشئ.
مثال على الاستخدام:
// المثال يوضح كيفية استخراج الصور من مستند PDF.
// إنشاء ImageExtractorOptions لتحديد التعليمات
var options = new ImageExtractorOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار الدليل للإخراج
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
var results = ImageExtractor.Process(options);
// الحصول على مسار نتيجة الصورة
var imageExtracted = results.ResultCollection[0].ToFile();
إصلاحات طفيفة
- إصلاحات داخلية.
- إصلاح الأمثلة والتلميحات لمحّول TIFF.
- تقليل مدة تحسين الصفحة.
- إصلاح: صورة الإخراج غير صحيحة من تحويل PDF إلى PNG.
- إصلاح: عدم عرض الأحرف الصينية بشكل صحيح أثناء تحويل PDF إلى PNG.
- تحسين: الأداء أثناء تحويل PDF إلى HTML.
v25.6
تحسين قابلية استخدام محول TIFF
- Class PdfToTiffOptions: تمت إضافة معلمة إضافية للتحويل - الضغط.
- Class PdfToTiffOptions: تمت إضافة معلمة إضافية للتحويل - عمق اللون.
- Class TiffConverter ثابت ولا يتطلب استخدام مُنشئ.
- تحسين الأمثلة الرئيسية.
أمثلة الاستخدام:
// المثال يوضح كيفية تحويل مستند PDF إلى تنسيق TIFF.
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// تنفيذ العملية
TiffConverter.Process(options);
// المثال يوضح كيفية تحويل مستند PDF إلى تنسيق TIFF مع معاملات إضافية.
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// معاملات اختيارية
options.PageList = new List<int> { 1, 3 };
options.MultiPage = true;
options.OutputResolution = 400;
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// تنفيذ العملية
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);
تحسين قابلية الاستخدام في الأمان
- الفئة ثابتة ولا تتطلب استخدام مُنشئ.
- تحسين الأمثلة الرئيسية.
أمثلة على الاستخدام:
// المثال يوضح كيفية تشفير مستند 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
تحسين قابلية استخدام المحسّن
- الصنف ثابت ولا يتطلب استخدام مُنشئ.
- تحسين المثال الرئيسي.
- إضافة أمثلة إضافية.
استخدام الأمثلة:
// المثال يوضح كيفية تحسين مستند PDF.
// إنشاء كائن OptimizeOptions لتعيين التعليمات
var options = new OptimizeOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);
// المثال يوضح كيفية تدوير مستند PDF.
// إنشاء كائن RotateOptions لتعيين التعليمات
var options = new RotateOptions();
// تعيين الدوران الجديد
options.Rotation = Rotation.On90;
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);
// المثال يوضح كيفية تغيير حجم مستند PDF.
// إنشاء كائن ResizeOptions لتعيين التعليمات
var options = new ResizeOptions();
// تعيين حجم الصفحة الجديد
options.PageSize = PageSize.A3;
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);
// المثال يوضح كيفية ضغط مستند PDF.
// إنشاء كائن CompressOptions لتعيين التعليمات
var options = new CompressOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);
تحسين قابلية استخدام الملحق المفسر
- الصنف ثابت ولا يتطلب استخدام مُنشئ.
- تحسين المثال الرئيسي.
استخدام الأمثلة:
// المثال يوضح كيفية تقسيم مستند PDF.
// إنشاء كائن SplitOptions لتعيين التعليمات
var options = new SplitOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسارات الملفات الناتجة
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// إجراء العملية
Splitter.Process(options);
تحسين قابلية استخدام الملحق الموحد
- الصنف ثابت ولا يتطلب استخدام مُنشئ.
- تحسين المثال الرئيسي.
استخدام الأمثلة:
// المثال يوضح كيفية دمج مستندين PDF.
// إنشاء كائن MergeOptions لتعيين التعليمات
var options = new MergeOptions();
// إضافة مسارات الملفات المدخلة
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Merger.Process(options);
إصلاحات طفيفة
v25.3
إضافة إضافة جديدة: مُسطّح النموذج
- Class FormFlattener: يمثل إضافة Documentize.FormFlattener المستخدمة لتسطح الحقول في مستندات PDF.
- Class FormFlattenerOptions: تمثل الخيارات لتسطح الحقول في المستند بواسطة إضافة Documentize.FormFlattener.
مثال على الاستخدام:
//المثال يوضح كيفية تسطح الحقول في ملف PDF.
// إنشاء كائن FormFlattenerOptions لتحديد التعليمات
var options = new FormFlattenerOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
//معامل اختياري لتخطي الحقل الذي يحمل الاسم "Surname".
options.SkipFields.Add("Surname");
// تنفيذ العملية
FormFlattener.Process(options);
//المثال يوضح كيفية الحصول على أسماء الحقول من ملف PDF.
var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");
إصلاحات طفيفة
- تحسين تلميحات الصفوف والأمثلة.
v25.2
إضافة ملحق جديد: مولد جدول المحتويات
- Class TocGenerator: يمثل ملحق Documentize.TocGenerator. يُستخدم لإضافة جدول محتويات إلى مستندات PDF.
- Class TocOptions: يمثل الخيارات لإضافة جدول محتويات إلى المستند بواسطة ملحق Documentize.TocGenerator.
- Class TocHeading: يمثل الخيارات للعناوين أو العناوين الفرعية لجدول المحتويات في المستند بواسطة ملحق Documentize.TocGenerator.
مثال على الاستخدام:
// المثال يوضح كيفية إضافة جدول محتويات إلى ملف PDF.
var options = new TocOptions();
// تعيين العنوان
options.Title = "جدول محتويات";
// توليد الروابط في العلامات
options.GenerateBookmarks = true;
// تصميم العناوين
options.Headings.Add(new TocHeading("المقدمة", 2, false, 1));
options.Headings.Add(new TocHeading("الفصل الأول", 3, true, 1));
options.Headings.Add(new TocHeading("الفصل الثاني", 4, true, 1));
options.Headings.Add(new TocHeading("مثال A", 4, true, 2));
options.Headings.Add(new TocHeading("مثال B", 4, true, 2));
options.Headings.Add(new TocHeading("مثال C", 4, true, 2));
options.Headings.Add(new TocHeading("مثال D", 4, true, 2));
options.Headings.Add(new TocHeading("الفصل الثالث", 5, true, 1));
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
TocGenerator.Process(options);
إصلاحات طفيفة
- تحسين تلميحات الفصول والأمثلة.
- تحديث العلامات المائية.
- تحسين تحويل PDF إلى XSLX.
- تحسين تحويل PDF إلى PDF/A-1a.
v25.1
- إضافة تجميع المخرجات إلى ImageExtractorOptions.
- إضافة دعم لمدخلات متعددة إلى ImageExtractorOptions.
- إصلاح تدفقات المخرجات المغلقة.
مثال على الاستخدام:
// انشاء كائن ImageExtractor لاستخراج الصور
var plugin = new ImageExtractor();
// انشاء ImageExtractorOptions
var opt = new ImageExtractorOptions();
// إضافة مسار ملف المدخل
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين دليل المخرجات
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ عملية الاستخراج
var resultContainer = plugin.Process(opt);
// الحصول على الصورة من كائن ResultContainer
var imageExtracted = resultContainer.ResultCollection[0].ToFile();
إصلاحات صغيرة
- تحسين تلميحات الفئات والأمثلة.
- التحقق من صحة توقيع PDF.
- تحسين دعم الأحرف الصينية.
v24.12
أضيفت ملحق جديد: محول PDF إلى PNG
- الفئة PngConverter: تمثل ملحق Documentize.PngConverter. تستخدم لتحويل مستندات PDF إلى تنسيق PNG.
- الفئة PdfToPngOptions: تمثل خيارات محول PDF إلى PNG لملحق Documentize.PngConverter.
مثال على الاستخدام:
// إنشاء PngConverter
var plugin = new PngConverter();
// إنشاء كائن PdfToPngOptions لتحديد التعليمات
var opt = new PdfToPngOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
plugin.Process(opt);
أضيفت ملحق جديد: محول PDF إلى TIFF
- الفئة TiffConverter: تمثل ملحق Documentize.TiffConverter. تستخدم لتحويل مستندات PDF إلى تنسيق TIFF.
- الفئة PdfToTiffOptions: تمثل خيارات محول PDF إلى TIFF لملحق Documentize.TiffConverter.
مثال على الاستخدام:
// إنشاء TiffConverter
var plugin = new TiffConverter();
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var opt = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
plugin.Process(opt);
أضيفت ملحق جديد: مُولد جدول PDF
- الفئة TableGenerator: تمثل ملحق Documentize.TableGenerator. تستخدم لإضافة جدول إلى مستند PDF.
- الفئة TableBuilder: تمثل البناء للجدول في صفحة PDF.
- الفئة TableRowBuilder: تمثل البناء لصف الجدول.
- الفئة TableRowBuilder: تمثل البناء لخلية الجدول.
مثال على الاستخدام:
// إنشاء TableGenerator
var plugin = new TableGenerator();
// إنشاء كائن TableOptions لتحديد التعليمات
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");
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// تنفيذ العملية
plugin.Process(opt);
إعادة تسمية الفئة PdfDoc إلى DocConverter
- الفئة DocConverter: تمثل ملحق Documentize.DocConverter. تستخدم لتحويل مستندات PDF إلى تنسيق DOC/DOCX.
مثال على الاستخدام:
// إنشاء DocConverter
var plugin = new DocConverter();
// إنشاء كائن PdfToDocOptions لتحديد التعليمات
var opt = new PdfToDocOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource(inputPath));
// تعيين مسار ملف الإخراج
opt.AddOutput(new FileDataSource(outputPath));
// تنفيذ العملية
plugin.Process(opt);
v24.11
إضافة مكون إضافي جديد: محول PDF إلى JPEG
- الهدف: تم تصميم فئة
JpegConverter لتحويل مستندات PDF إلى تنسيق JPEG، مما يسهل على المستخدمين التعامل مع الصور المشتقة من مستندات PDF ومشاركتها. - الباني:
JpegConverter(): يقوم بتهيئة مثيل جديد من محول 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): يقوم بتهيئة كائن بيانات دليل جديد باستخدام المسار المحدد.
مثال على الاستخدام:
var directorySource = new DirectoryDataSource("path_to_your_directory");
- الخصائص:
DataType: يسترجع نوع مصدر البيانات.Path: يحصل على مسار الدليل الحالي للبيانات.
إضافة فئة PdfToJpegOptions
- الهدف: تحتوي هذه الفئة على خيارات لتكوين عملية تحويل JPEG، مما يسمح للمستخدمين بتحديد الدقة، قوائم الصفحات، وجودة الصورة.
- الباني:
PdfToJpegOptions(): يقوم بتهيئة مثيل خيارات جديد لمحول 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
تم الإصدار