Class PdfSecurity

معلومات

يمثل مكوّن Documentize.PdfSecurity. يُستخدم لتشفير، فك تشفير، توقيع، وتنظيف مستندات PDF.

public static class PdfSecurity

الوراثة

objectPdfSecurity

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

الطرق

Decrypt(DecryptOptions)

فك تشفير مستند PDF.

public static ResultContainer Decrypt(DecryptOptions options)

المعلمات

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

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

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

أمثلة

المثال يوضح كيفية فك تشفير مستند PDF.

// Create DecryptOptions object to set instructions
var options = new DecryptOptions("123456");
// 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.Decrypt(options);

الاستثناءات

ArgumentException

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

Encrypt(EncryptOptions)

تشفير مستند PDF.

public static ResultContainer Encrypt(EncryptOptions options)

المعلمات

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

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

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

أمثلة

المثال يوضح كيفية تشفير مستند PDF.

// 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);

الاستثناءات

ArgumentException

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

Sanitize(SanitizeOptions)

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

public static ResultContainer Sanitize(SanitizeOptions options)

المعلمات

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

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

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

أمثلة

المثال يوضح كيفية تنظيف مستند 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 من Stream إلى Stream.

// 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 من ملف إلى Stream.

// Prepare output stream
using var outputStream = new MemoryStream();
// Create SanitizeOptions object to set input and output streams
var options = new SanitizeOptions("path_to_your_pdf_file.pdf", outputStream);
// Perform the process
PdfSecurity.Sanitize(options);

المثال يوضح كيفية تنظيف PDF من ملف إلى Stream مع ضبط يدوي لخصائص الإدخال والإخراج.

// 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 بأقصر أسلوب ممكن.

// Perform the process
PdfSecurity.Sanitize(new SanitizeOptions("path_to_your_pdf_file.pdf", "path_to_result_pdf_file.pdf"));

الاستثناءات

ArgumentException

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

Sign(SignOptions)

توقيع مستند PDF بالتوقيع الرقمي.

public static ResultContainer Sign(SignOptions options)

المعلمات

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

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

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

أمثلة

المثال يوضح كيفية توقيع مستند 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 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);

المثال يوضح كيفية توقيع مستند PDF باستخدام Stream لملف PFX.

using var pfxStream = File.OpenRead(@"path_to_your_pfx_file.pfx");
var options = new SignOptions(pfxStream, "password_of_your_pfx_file");
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Perform the process
PdfSecurity.Sign(options);

المثال يوضح كيفية توقيع مستند PDF بتوقيع غير مرئي.

var options = new SignOptions("path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Configure invisible signature
signOptions.Visible = false;
// Perform the process
PdfSecurity.Sign(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 FileData("path_to_your_pdf_file.pdf"));
// Set output file path
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Optional parameters
options.Reason = "my Reason";
options.Contact = "my Contact";
options.Location = "my Location";
options.PageNumber = 3;
// Perform the process
PdfSecurity.Sign(options);

المثال يوضح كيفية توقيع مستند PDF مع طابع زمني.

// 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 FileData("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Perform the process
PdfSecurity.Sign(options);

الاستثناءات

ArgumentException

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

النطاق: Documentize
المجمّع: Documentize.dll

 عربي