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 المُنتج