Class Document

Namespace: Aspose.Pdf
Assembly: Aspose.PDF.dll

Class representing PDF document

public sealed class Document : IDisposable

Inheritance

object ← Document

Implements

IDisposable

Inherited Members

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Constructors

Document(Stream)

تهيئة مثيل جديد من Document من دفق input.

public Document(Stream input)

Parameters

input Stream

دفق يحتوي على مستند PDF.

Document(Stream, string, bool)

تهيئة مثيل جديد من Document من دفق input.

public Document(Stream input, string password, bool isManagedStream)

Parameters

input Stream

دفق يحتوي على مستند PDF.

password string

كلمة مرور المستخدم أو المالك.

isManagedStream bool

إذا تم تعيينها إلى true، يتم إغلاق الدفق الداخلي قبل الخروج؛ خلاف ذلك، لا يتم ذلك.

Document(Stream, bool)

تهيئة مثيل جديد من Document من دفق input.

public Document(Stream input, bool isManagedStream)

Parameters

input Stream

دفق يحتوي على مستند PDF.

isManagedStream bool

إذا تم تعيينها إلى true، يتم إغلاق الدفق الداخلي قبل الخروج؛ خلاف ذلك، لا يتم ذلك.

Document(string)

فقط قم بتهيئة Document باستخدام filename. نفس الشيء كما Aspose.Pdf.Document.#ctor(System.IO.Stream).

public Document(string filename)

Parameters

filename string

اسم ملف مستند PDF.

Document(Stream, string)

تهيئة مثيل جديد من Document من دفق input.

public Document(Stream input, string password)

Parameters

input Stream

كائن دفق الإدخال، PDF المقابل محمي بكلمة مرور.

password string

كلمة مرور المستخدم أو المالك.

Document()

تهيئة مستند فارغ.

public Document()

Document(string, string)

تهيئة مثيل جديد من فئة Aspose.Pdf.Document للعمل مع مستند مشفر.

public Document(string filename, string password)

Parameters

filename string

اسم ملف المستند.

password string

كلمة مرور المستخدم أو المالك.

Document(string, string, bool)

تهيئة مثيل جديد من فئة Aspose.Pdf.Document للعمل مع مستند مشفر.

public Document(string filename, string password, bool isManagedStream)

Parameters

filename string

اسم ملف المستند.

password string

كلمة مرور المستخدم أو المالك.

isManagedStream bool

إذا تم تعيينها إلى true، يتم إغلاق الدفق الداخلي قبل الخروج؛ خلاف ذلك، لا يتم ذلك.

Document(string, LoadOptions)

يفتح مستندًا موجودًا من ملف مع توفير خيارات التحويل اللازمة للحصول على مستند PDF.

public Document(string filename, LoadOptions options)

Parameters

filename string

ملف الإدخال للتحويل إلى مستند PDF.

options LoadOptions

تمثل الخصائص لتحويل filename إلى مستند PDF.

Document(Stream, LoadOptions)

يفتح مستندًا موجودًا من دفق مع توفير خيارات التحويل اللازمة للحصول على مستند PDF.

public Document(Stream input, LoadOptions options)

Parameters

input Stream

دفق الإدخال للتحويل إلى مستند PDF.

options LoadOptions

تمثل الخصائص لتحويل input إلى مستند PDF.

Fields

DefaultNodesNumInSubtrees

public const byte DefaultNodesNumInSubtrees = 10

Field Value

byte

Properties

Actions

يحصل على إجراءات المستند. هذه الخاصية هي مثيل من فئة DocumentActions التي تسمح بالحصول على/تعيين إجراءات BeforClosing و BeforSaving، إلخ.

public DocumentActionCollection Actions { get; }

Property Value

DocumentActionCollection

Examples

هذا المثال يوضح كيفية الحصول على إجراء بعد فتح المستند:

Aspose.Pdf.Document document = new Aspose.Pdf.Document("d:\\work\\aspose\\aspose.pdf.kit.net.new\\trunk\\testdata\\Aspose.Pdf\\PdfWithOpenAction.pdf");
Aspose.Pdf.Annotations.DocumentActionCollection actions = document.Actions;
Aspose.Pdf.Annotations.PdfAction afterSavingAction = actions.AfterSaving;

AllowReusePageContent

يسمح بدمج محتويات الصفحة لتحسين حجم المستند. إذا تم استخدامه، فقد تشير الصفحات المختلفة ولكن المكررة إلى نفس كائن المحتوى. يرجى ملاحظة أن هذا الوضع قد يسبب آثارًا جانبية مثل تغيير محتوى الصفحة عند تغيير صفحة أخرى.

public bool AllowReusePageContent { get; set; }

Property Value

bool

Background

يحصل على أو يحدد لون خلفية المستند.

public Color Background { get; set; }

Property Value

Color

CenterWindow

يحصل على أو يحدد علامة تشير إلى ما إذا كان يجب أن يتم تمركز نافذة المستند على الشاشة.

public bool CenterWindow { get; set; }

Property Value

bool

Examples

المثال يوضح كيفية الحصول على علامة CenterWindow:

Document document = new Document("sample.pdf");
bool value = document.CenterWindow;

Collection

يحصل على مجموعة المستندات.

public Collection Collection { get; set; }

Property Value

Collection

CryptoAlgorithm

يحصل على إعدادات الأمان إذا كان المستند مشفرًا. إذا لم يكن المستند مشفرًا، فسيتم رفع الاستثناء المقابل في .net 1.1 أو سيكون CryptoAlgorithm فارغًا للإصدارات الأخرى من .net.

public CryptoAlgorithm? CryptoAlgorithm { get; }

Property Value

CryptoAlgorithm?

Destinations

يحصل على مجموعة الوجهات. عفا عليها الزمن. يرجى استخدام NamedDestinations.

public DestinationCollection Destinations { get; }

Property Value

DestinationCollection

Direction

يحصل على أو يحدد ترتيب قراءة النص: L2R (من اليسار إلى اليمين) أو R2L (من اليمين إلى اليسار).

public Direction Direction { get; set; }

Property Value

Direction

DisableFontLicenseVerifications

العديد من العمليات مع الخط لا يمكن تنفيذها إذا كانت هذه العمليات محظورة بواسطة ترخيص هذا الخط. على سبيل المثال، لا يمكن تضمين بعض الخطوط في مستند PDF إذا كانت قواعد الترخيص تمنع التضمين لهذا الخط. تُستخدم هذه العلامة لتعطيل أي قيود ترخيص لجميع الخطوط في مستند PDF الحالي. كن حذرًا عند استخدام هذه العلامة. عندما يتم تعيينها، فهذا يعني أن الشخص الذي يحدد هذه العلامة، يتحمل كل المسؤولية عن انتهاكات الترخيص/القانون المحتملة على عاتقه. لذا، يتحملها على مسؤوليته الخاصة. يوصى بشدة باستخدام هذه العلامة فقط عندما تكون واثقًا تمامًا من أنك لا تخالف قانون حقوق النشر. بشكل افتراضي، تكون القيمة false.

public bool DisableFontLicenseVerifications { get; set; }

Property Value

bool

DisplayDocTitle

يحصل على أو يحدد علامة تشير إلى ما إذا كان يجب أن تعرض شريط عنوان نافذة المستند عنوان المستند.

public bool DisplayDocTitle { get; set; }

Property Value

bool

Examples

المثال يوضح كيفية الحصول على علامة DisplayDocTitle:

Document document = new Document("sample.pdf");
bool value = document.DisplayDocTitle;

Duplex

يحصل على أو يحدد خيار معالجة وضع الطباعة المزدوج لاستخدامه عند طباعة الملف من مربع الحوار للطباعة.

public PrintDuplex Duplex { get; set; }

Property Value

PrintDuplex

EmbedStandardFonts

خاصية تعلن أن المستند يجب أن يتضمن جميع خطوط Type1 القياسية التي تم تعيين علامة IsEmbedded فيها إلى true. يمكن تضمين جميع خطوط PDF في المستند ببساطة عن طريق تعيين علامة IsEmbedded إلى true، ولكن خطوط PDF القياسية من نوع Type1 هي استثناء من هذه القاعدة. يتطلب تضمين خط Type1 القياسي الكثير من الوقت، لذا لتضمين هذه الخطوط، من الضروري ليس فقط تعيين علامة IsEmbedded إلى true للخط المحدد ولكن أيضًا تعيين علامة إضافية على مستوى المستند - EmbedStandardFonts = true; يمكن تعيين هذه الخاصية مرة واحدة فقط لجميع الخطوط. بشكل افتراضي، تكون القيمة false.

public bool EmbedStandardFonts { get; set; }

Property Value

bool

EmbeddedFiles

يحصل على مجموعة من الملفات المدمجة في المستند.

public EmbeddedFileCollection EmbeddedFiles { get; }

Property Value

EmbeddedFileCollection

EnableObjectUnload

يحصل على أو يحدد علامة تمكن المستند من أن يتم تفريغه جزئيًا من الذاكرة. يسمح ذلك بتقليل استخدام الذاكرة ولكنه قد يؤثر سلبًا على الأداء.

public bool EnableObjectUnload { get; set; }

Property Value

bool

EnableSignatureSanitization

يحصل على أو يحدد علامة لإدارة تطهير حقول التوقيع. مفعل بشكل افتراضي.

public bool EnableSignatureSanitization { get; set; }

Property Value

bool

FileName

اسم ملف PDF الذي تسبب في هذا المستند

public string FileName { get; }

Property Value

string

FitWindow

يحصل على أو يحدد علامة تشير إلى ما إذا كان يجب تغيير حجم نافذة المستند لتناسب الصفحة الأولى المعروضة.

public bool FitWindow { get; set; }

Property Value

bool

Examples

المثال يوضح كيفية الحصول على علامة FitWindow:

Document document = new Document("sample.pdf");
bool value = document.FitWindow;

FontUtilities

مثيل من IDocumentFontUtilities

public Document.IDocumentFontUtilities FontUtilities { get; }

Property Value

Document.IDocumentFontUtilities

Form

يحصل على نموذج Acro الخاص بالمستند.

public Form Form { get; }

Property Value

Form

HandleSignatureChange

ارفع استثناء إذا كان المستند سيتم حفظه مع التغييرات ويحتوي على توقيع

public bool HandleSignatureChange { get; set; }

Property Value

bool

HideMenubar

يحصل على أو يحدد علامة تشير إلى ما إذا كان يجب إخفاء شريط القائمة عندما يكون المستند نشطًا.

public bool HideMenubar { get; set; }

Property Value

bool

Examples

المثال يوضح كيفية الحصول على علامة HideMenubar:

Document document = new Document("sample.pdf");
bool value = document.HideMenubar;

HideToolBar

يحصل على أو يحدد علامة تشير إلى ما إذا كان يجب إخفاء شريط الأدوات عندما يكون المستند نشطًا.

public bool HideToolBar { get; set; }

Property Value

bool

Examples

المثال يوضح كيفية الحصول على علامة HideToolBar:

Document document = new Document("sample.pdf");
bool value = document.HideToolBar;

HideWindowUI

يحصل على أو يحدد علامة تشير إلى ما إذا كان يجب إخفاء عناصر واجهة المستخدم عندما يكون المستند نشطًا.

public bool HideWindowUI { get; set; }

Property Value

bool

Examples

المثال يوضح كيفية الحصول على علامة HideWindowUI:

Document document = new Document("sample.pdf");
bool value = document.HideWindowUI;

Id

يحصل على المعرف.

public Id Id { get; }

Property Value

Id

IgnoreCorruptedObjects

يحصل على أو يحدد علامة تجاهل الأخطاء في الملفات المصدر. عند نسخ الصفحات من مستند المصدر إلى المستند الوجهة، تتوقف عملية النسخ مع استثناء إذا كانت بعض الكائنات في الملفات المصدر تالفة عندما تكون هذه العلامة false. مثال: dest.Pages.Add(src.Pages); إذا تم تعيين هذه العلامة إلى true، فسيتم استبدال الكائنات التالفة بقيم فارغة. بشكل افتراضي: true.

public bool IgnoreCorruptedObjects { get; set; }

Property Value

bool

Info

يحصل على معلومات المستند.

public DocumentInfo Info { get; }

Property Value

DocumentInfo

IsEncrypted

يحصل على حالة تشفير المستند. true إذا كان المستند مشفرًا.

public bool IsEncrypted { get; }

Property Value

bool

IsLicensed

يحصل على حالة الترخيص للنظام. يرجع true إذا كان النظام يعمل في وضع مرخص و false خلاف ذلك.

public static bool IsLicensed { get; }

Property Value

bool

IsLinearized

يحصل على أو يحدد قيمة تشير إلى ما إذا كان المستند مُخططًا.

public bool IsLinearized { get; set; }

Property Value

bool

IsPdfUaCompliant

يحصل على ما إذا كان المستند متوافقًا مع PDF/UA.

public bool IsPdfUaCompliant { get; }

Property Value

bool

IsPdfaCompliant

يحصل على ما إذا كان المستند متوافقًا مع PDF/A.

public bool IsPdfaCompliant { get; }

Property Value

bool

IsXrefGapsAllowed

يحصل على أو يحدد ما إذا كان يُسمح بفجوات Xref في المستند.

public bool IsXrefGapsAllowed { get; set; }

Property Value

bool

JavaScript

مجموعة من JavaScript على مستوى المستند.

public JavaScriptCollection JavaScript { get; }

Property Value

JavaScriptCollection

LogicalStructure

يحصل على الهيكل المنطقي للمستند.

public RootElement LogicalStructure { get; }

Property Value

RootElement

Metadata

بيانات التعريف الخاصة بالمستند. (قد يتضمن مستند PDF معلومات عامة، مثل عنوان المستند، المؤلف، وتواريخ الإنشاء والتعديل. تسمى هذه المعلومات العامة حول المستند (على عكس محتواه أو هيكله) بيانات التعريف وتهدف إلى المساعدة في فهرسة المستندات والبحث عنها في قواعد البيانات الخارجية.)

public Metadata Metadata { get; }

Property Value

Metadata

NamedDestinations

مجموعة من الوجهات المسماة في المستند.

public NamedDestinationCollection NamedDestinations { get; }

Property Value

NamedDestinationCollection

NonFullScreenPageMode

يحصل على أو يحدد وضع الصفحة، مما يحدد كيفية عرض المستند عند الخروج من وضع ملء الشاشة.

public PageMode NonFullScreenPageMode { get; set; }

Property Value

PageMode

OpenAction

يحصل على أو يحدد الإجراء الذي يتم تنفيذه عند فتح المستند.

public IAppointment OpenAction { get; set; }

Property Value

IAppointment

Examples

المثال يوضح كيفية الحصول على علامة CenterWindow:

Document document = new Document("sample.pdf");
IAppointment value = document.OpenAction;

OptimizeSize

يحصل على أو يحدد علامة التحسين. عندما تتم إضافة صفحات إلى المستند، يتم دمج تدفقات الموارد المتساوية في الملف الناتج في كائن PDF واحد إذا تم تعيين هذه العلامة. يسمح ذلك بتقليل حجم الملف الناتج ولكنه قد يتسبب في بطء التنفيذ وزيادة متطلبات الذاكرة. القيمة الافتراضية: false.

public bool OptimizeSize { get; set; }

Property Value

bool

Outlines

يحصل على مخططات المستند.

public OutlineCollection Outlines { get; }

Property Value

OutlineCollection

OutputIntents

يحصل على مجموعة من نوايا الإخراج في المستند.

public OutputIntents OutputIntents { get; }

Property Value

OutputIntents

PageInfo

يحصل على أو يحدد معلومات الصفحة. (للمولد فقط، غير مملوء عند قراءة المستند)

public PageInfo PageInfo { get; set; }

Property Value

PageInfo

PageLabels

يحصل على تسميات الصفحات في المستند.

public PageLabelCollection PageLabels { get; }

Property Value

PageLabelCollection

PageLayout

يحصل على أو يحدد تخطيط الصفحة الذي يجب استخدامه عند فتح المستند.

public PageLayout PageLayout { get; set; }

Property Value

PageLayout

PageMode

يحصل على أو يحدد وضع الصفحة، مما يحدد كيفية عرض المستند عند فتحه.

public PageMode PageMode { get; set; }

Property Value

PageMode

Pages

يحصل على أو يحدد مجموعة صفحات المستند. يرجى ملاحظة أن الصفحات مرقمة من 1 في المجموعة.

public PageCollection Pages { get; }

Property Value

PageCollection

Examples

المثال أدناه يوضح كيفية العمل مع صفحات المستند: كيفية الحصول على عدد الصفحات وكيفية الحصول على مستطيل الصفحة الأولى من المستند.

Aspose.Pdf.Document document = new Aspose.Pdf.Document("sample.pdf");
Aspose.Pdf.PageCollection pages = document.Pages;
System.Console.WriteLine("Document contains " + pages.Count);
Page page = pages[1];
Rectangle rect = page.Rect;

PdfFormat

يحصل على تنسيق PDF

public PdfFormat PdfFormat { get; }

Property Value

PdfFormat

Permissions

يحصل على أذونات المستند.

public int Permissions { get; }

Property Value

int

PickTrayByPdfSize

يحصل على أو يحدد علامة تشير إلى ما إذا كان يجب استخدام حجم صفحة PDF لاختيار درج الورق الإدخالي.

public bool PickTrayByPdfSize { get; set; }

Property Value

bool

PrintScaling

يحصل على أو يحدد خيار تغيير حجم الصفحة الذي يجب تحديده عند عرض مربع الحوار للطباعة لهذا المستند.

public PrintScaling PrintScaling { get; set; }

Property Value

PrintScaling

TaggedContent

يحصل على الوصول إلى محتوى TaggedPdf.

public ITaggedContent TaggedContent { get; }

Property Value

ITaggedContent

Examples

المثال يوضح كيفية استخدام المحتوى المسمى لإنشاء مستند جديد مع رأس، فقرات وصور.

// إنشاء مستند جديد
Document document = new Document();

// الحصول على المحتوى المسمى
ITaggedContent taggedContent = document.TaggedContent;

// تعيين اللغة للمستند
taggedContent.SetLanguage("en-US");

// تعيين العنوان لمستند PDF
taggedContent.SetTitle("مثال على مستند");

// إنشاء وإضافة قسم
SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);

// إنشاء رأس
HeaderElement h1 = taggedContent.CreateHeaderElement(1);
h1.SetText("العنوان");
sect.AppendChild(h1);

// إنشاء فقرة
ParagraphElement p = taggedContent.CreateParagraphElement();
p.SetTag("فقرة");
p.SetText("نص الفقرة.");
sect.AppendChild(p);

// إنشاء توضيح
IllustrationElement figure1 = taggedContent.CreateFigureElement();
sect.AppendChild(figure1);
figure1.AlternativeText = "الشكل 1";
figure1.Title = "الصورة 1";
figure1.SetTag("شكل");
figure1.SetImage("path/of/image.jpg");

// حفظ المستند
document.Save("example.pdf");

Version

يحصل على إصدار PDF من رأس ملف PDF.

public string Version { get; }

Property Value

string

Methods

BindXml(string)

يربط XML بالمستند

public void BindXml(string file)

Parameters

file string

ملف XML

BindXml(string, string)

يربط XML/XSL بالمستند

public void BindXml(string xmlFile, string xslFile)

Parameters

xmlFile string

ملف XML.

xslFile string

ملف XSL إذا تم استخدام XSLT.

BindXml(Stream, Stream)

يربط XML/XSL بالمستند

public void BindXml(Stream xmlStream, Stream xslStream)

Parameters

xmlStream Stream

دفق XML.

xslStream Stream

دفق XSL إذا تم استخدام XSLT.

BindXml(Stream, Stream, XmlReaderSettings)

يربط XML/XSL بالمستند

public void BindXml(Stream xmlStream, Stream xslStream, XmlReaderSettings settings)

Parameters

xmlStream Stream

دفق XML.

xslStream Stream

دفق XSL إذا تم استخدام XSLT.

settings XmlReaderSettings

إعدادات قارئ XML.

BindXml(Stream)

يربط XML بالمستند

public void BindXml(Stream stream)

Parameters

stream Stream

دفق XML.

ChangePasswords(string, string, string)

يغير كلمات مرور المستند. يمكن إجراء هذا الإجراء فقط باستخدام كلمة مرور المالك.

public void ChangePasswords(string ownerPassword, string newUserPassword, string newOwnerPassword)

Parameters

ownerPassword string

كلمة مرور المالك.

newUserPassword string

كلمة مرور المستخدم الجديدة.

newOwnerPassword string

كلمة مرور المالك الجديدة.

Check(bool)

يحقق من صحة المستند.

public bool Check(bool doRepair)

Parameters

doRepair bool

إذا كانت true، سيتم إصلاح المشكلات الموجودة.

Returns

bool

true - إذا تم إصلاح المستند؛ خلاف ذلك، false.

Convert(string, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)

يحول المستند ويحفظ الأخطاء في الملف المحدد.

public bool Convert(string outputLogFileName, PdfFormat format, ConvertErrorAction action, ConvertTransparencyAction transparencyAction)

Parameters

outputLogFileName string

المسار إلى الملف حيث سيتم تخزين التعليقات.

format PdfFormat

تنسيق PDF.

action ConvertErrorAction

الإجراء للكائنات التي لا يمكن تحويلها.

transparencyAction ConvertTransparencyAction

الإجراء للكائنات المmasked بالصورة.

Returns

bool

نتيجة العملية

Convert(Stream, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)

يحول المستند ويحفظ الأخطاء في الملف المحدد.

public bool Convert(Stream outputLogStream, PdfFormat format, ConvertErrorAction action, ConvertTransparencyAction transparencyAction)

Parameters

outputLogStream Stream

دفق حيث سيتم تخزين التعليقات.

format PdfFormat

تنسيق PDF.

action ConvertErrorAction

الإجراء للكائنات التي لا يمكن تحويلها.

transparencyAction ConvertTransparencyAction

الإجراء للكائنات المmasked بالصورة.

Returns

bool

نتيجة العملية

Convert(string, PdfFormat, ConvertErrorAction)

يحول المستند ويحفظ الأخطاء في الملف المحدد.

public bool Convert(string outputLogFileName, PdfFormat format, ConvertErrorAction action)

Parameters

outputLogFileName string

المسار إلى الملف حيث سيتم تخزين التعليقات.

format PdfFormat

تنسيق PDF.

action ConvertErrorAction

الإجراء للكائنات التي لا يمكن تحويلها.

Returns

bool

نتيجة العملية

Convert(PdfFormatConversionOptions)

يحول المستند باستخدام خيارات التحويل المحددة

public bool Convert(PdfFormatConversionOptions options)

Parameters

options PdfFormatConversionOptions

مجموعة من الخيارات لتحويل مستند PDF

Returns

bool

نتيجة العملية

Convert(CallBackGetHocrWithPage, bool)

يتعرف على الصور داخل المستند ويضيف سلاسل hocr فوقها.

public bool Convert(Document.CallBackGetHocrWithPage callback, bool flattenImages = false)

Parameters

callback Document.CallBackGetHocrWithPage

إجراء للصور التي سيتم معالجتها بواسطة التعرف على hocr.

flattenImages bool

يمكن رسم النص في صور PDF باستخدام آلية الأقنعة، في هذه الحالة يجب تسطيح الصور.

Returns

bool

نتيجة العملية. إذا لم تكن هناك صور في المستند، ترجع false.

Convert(CallBackGetHocr, bool)

يتعرف على الصور داخل المستند ويضيف سلاسل hocr فوقها.

public bool Convert(Document.CallBackGetHocr callback, bool flattenImages = false)

Parameters

callback Document.CallBackGetHocr

إجراء للصور التي سيتم معالجتها بواسطة التعرف على hocr.

flattenImages bool

يمكن رسم النص في صور PDF باستخدام آلية الأقنعة، في هذه الحالة يجب تسطيح الصور.

Returns

bool

نتيجة العملية. إذا لم تكن هناك صور في المستند، ترجع false.

Convert(Stream, PdfFormat, ConvertErrorAction)

يحول المستند ويحفظ الأخطاء في الدفق المحدد.

public bool Convert(Stream outputLogStream, PdfFormat format, ConvertErrorAction action)

Parameters

outputLogStream Stream

دفق حيث سيتم تخزين التعليقات.

format PdfFormat

تنسيق PDF.

action ConvertErrorAction

الإجراء للكائنات التي لا يمكن تحويلها.

Returns

bool

نتيجة العملية

Convert(Fixup, Stream, bool, object[])

يحول المستند عن طريق تطبيق Fixup.

public bool Convert(Fixup fixup, Stream outputLog, bool onlyValidation = false, object[] parameters = null)

Parameters

fixup Fixup

نوع Fixup.

outputLog Stream

سجل العملية.

onlyValidation bool

تحقق فقط من صحة المستند.

parameters object[]

الخصائص لـ Fixup التي لا يمكن تعيينها.

Returns

bool

نتيجة العملية.

Convert(Fixup, string, bool, object[])

يحول المستند عن طريق تطبيق Fixup.

public bool Convert(Fixup fixup, string outputLog, bool onlyValidation = false, object[] parameters = null)

Parameters

fixup Fixup

نوع Fixup.

outputLog string

سجل العملية.

onlyValidation bool

تحقق فقط من صحة المستند.

parameters object[]

الخصائص لـ Fixup التي لا يمكن تعيينها.

Returns

bool

نتيجة العملية.

Convert(string, LoadOptions, string, SaveOptions)

يحول ملف المصدر في التنسيق المصدر إلى ملف الوجهة في التنسيق الوجهة.

public static void Convert(string srcFileName, LoadOptions loadOptions, string dstFileName, SaveOptions saveOptions)

Parameters

srcFileName string

اسم ملف المصدر.

loadOptions LoadOptions

تنسيق الملف المصدر.

dstFileName string

اسم ملف الوجهة.

saveOptions SaveOptions

تنسيق الملف الوجهة.

Convert(Stream, LoadOptions, string, SaveOptions)

يحول دفق في التنسيق المصدر إلى ملف الوجهة في التنسيق الوجهة.

public static void Convert(Stream srcStream, LoadOptions loadOptions, string dstFileName, SaveOptions saveOptions)

Parameters

srcStream Stream

الدفق المصدر.

loadOptions LoadOptions

تنسيق الدفق المصدر.

dstFileName string

اسم ملف الوجهة.

saveOptions SaveOptions

تنسيق الملف الوجهة.

Convert(string, LoadOptions, Stream, SaveOptions)

يحول ملف المصدر في التنسيق المصدر إلى دفق في التنسيق الوجهة.

public static void Convert(string srcFileName, LoadOptions loadOptions, Stream dstStream, SaveOptions saveOptions)

Parameters

srcFileName string

اسم ملف المصدر.

loadOptions LoadOptions

تنسيق الملف المصدر.

dstStream Stream

الدفق الوجهة.

saveOptions SaveOptions

تنسيق الدفق الوجهة.

Convert(Stream, LoadOptions, Stream, SaveOptions)

يحول دفق في التنسيق المصدر إلى دفق في التنسيق الوجهة.

public static void Convert(Stream srcStream, LoadOptions loadOptions, Stream dstStream, SaveOptions saveOptions)

Parameters

srcStream Stream

الدفق المصدر.

loadOptions LoadOptions

تنسيق الدفق المصدر.

dstStream Stream

الدفق الوجهة.

saveOptions SaveOptions

تنسيق الملف الوجهة.

ConvertPageToPNGMemoryStream(Page)

يحول الصفحة إلى PNG لتدفق الصورة DSR، OMR، OCR.

public MemoryStream ConvertPageToPNGMemoryStream(Page page)

Parameters

page Page

الصفحة للتحويل.

Returns

MemoryStream

تدفق الصورة.

Decrypt()

يفك تشفير المستند. اتصل بعد ذلك بـ Save للحصول على نسخة مفككة من المستند.

public void Decrypt()

Dispose()

يغلق جميع الموارد المستخدمة بواسطة هذا المستند.

public void Dispose()

Encrypt(string, string, DocumentPrivilege, CryptoAlgorithm, bool)

يشفر المستند. اتصل بعد ذلك بـ Save للحصول على نسخة مشفرة من المستند.

public void Encrypt(string userPassword, string ownerPassword, DocumentPrivilege privileges, CryptoAlgorithm cryptoAlgorithm, bool usePdf20)

Parameters

userPassword string

كلمة مرور المستخدم.

ownerPassword string

كلمة مرور المالك.

privileges DocumentPrivilege

أذونات المستند، انظر Aspose.Pdf.Document.Permissions للحصول على التفاصيل.

cryptoAlgorithm CryptoAlgorithm

الخوارزمية التشفيرية، انظر Aspose.Pdf.Document.CryptoAlgorithm للحصول على التفاصيل.

usePdf20 bool

الدعم للإصدار 6 (الامتداد 8).

Encrypt(string, string, Permissions, CryptoAlgorithm)

يشفر المستند. اتصل بعد ذلك بـ Save للحصول على نسخة مشفرة من المستند.

public void Encrypt(string userPassword, string ownerPassword, Permissions permissions, CryptoAlgorithm cryptoAlgorithm)

Parameters

userPassword string

كلمة مرور المستخدم.

ownerPassword string

كلمة مرور المالك.

permissions Permissions

أذونات المستند، انظر Aspose.Pdf.Document.Permissions للحصول على التفاصيل.

cryptoAlgorithm CryptoAlgorithm

الخوارزمية التشفيرية، انظر Aspose.Pdf.Document.CryptoAlgorithm للحصول على التفاصيل.

Encrypt(string, string, Permissions, CryptoAlgorithm, bool)

يشفر المستند. اتصل بعد ذلك بـ Save للحصول على نسخة مشفرة من المستند.

public void Encrypt(string userPassword, string ownerPassword, Permissions permissions, CryptoAlgorithm cryptoAlgorithm, bool usePdf20)

Parameters

userPassword string

كلمة مرور المستخدم.

ownerPassword string

كلمة مرور المالك.

permissions Permissions

أذونات المستند، انظر Aspose.Pdf.Document.Permissions للحصول على التفاصيل.

cryptoAlgorithm CryptoAlgorithm

الخوارزمية التشفيرية، انظر Aspose.Pdf.Document.CryptoAlgorithm للحصول على التفاصيل.

usePdf20 bool

الدعم للإصدار 6 (الامتداد 8).

ExportAnnotationsToXfdf(string)

يصدر جميع تعليقات المستند إلى ملف XFDF

public void ExportAnnotationsToXfdf(string fileName)

Parameters

fileName string

اسم ملف XFDF

ExportAnnotationsToXfdf(Stream)

يصدر جميع تعليقات المستند إلى دفق.

public void ExportAnnotationsToXfdf(Stream stream)

Parameters

stream Stream

دفق حيث يتم تخزين XFDF.

Flatten()

يزيل جميع الحقول من المستند ويضع قيمها بدلاً منها.

public void Flatten()

Flatten(FlattenSettings)

يزيل جميع الحقول (والتعليقات التوضيحية) من المستند ويضع قيمها بدلاً منها.

public void Flatten(Form.FlattenSettings flattenSettings)

Parameters

flattenSettings Form.FlattenSettings

إعدادات عملية التسطيح.

FlattenTransparency()

يستبدل المحتوى الشفاف برسومات نقطية وبيانية غير شفافة.

public void FlattenTransparency()

FreeMemory()

يمسح الذاكرة

public void FreeMemory()

GetCatalogValue(string)

يرجع قيمة العنصر من قاموس الكتالوج.

public object GetCatalogValue(string key)

Parameters

key string

مفتاح العنصر.

Returns

object

قيمة العنصر - إذا تم العثور على المفتاح بنجاح؛ خلاف ذلك، null.

GetObjectById(string)

يحصل على كائن بالمعرف المحدد في المستند.

public object GetObjectById(string id)

Parameters

id string

معرف الكائن.

Returns

object

الكائن بالمعرف المحدد. Null إذا لم يتم العثور على المعرف.

GetXmpMetadata(Stream)

احصل على بيانات التعريف XMP من المستند.

public void GetXmpMetadata(Stream stream)

Parameters

stream Stream

دفق حيث سيتم تخزين البيانات التعريف.

HasIncrementalUpdate()

يتحقق مما إذا كان مستند PDF الحالي قد تم حفظه بتحديثات تزايدية.

public bool HasIncrementalUpdate()

Returns

bool

true إذا كان مستند PDF يحتوي على تحديثات تزايدية؛ خلاف ذلك، false.

ImportAnnotationsFromXfdf(string)

يستورد التعليقات من ملف XFDF إلى المستند.

public void ImportAnnotationsFromXfdf(string fileName)

Parameters

fileName string

اسم ملف XFDF

ImportAnnotationsFromXfdf(Stream)

يستورد التعليقات من الدفق إلى المستند.

public void ImportAnnotationsFromXfdf(Stream stream)

Parameters

stream Stream

دفق يحتوي على بيانات XFDF.

LoadFrom(string, LoadOptions)

يحمّل ملفًا، محولًا إياه إلى PDF.

public void LoadFrom(string filename, LoadOptions options)

Parameters

filename string

المسار إلى الملف الذي سيتم فتحه.

options LoadOptions

خيارات التحميل.

Exceptions

PdfException

إذا لم يكن بالإمكان تحميل الملف.

FileNotFoundException

إذا لم يتم العثور على الملف.

Merge(MergeOptions, params Document[])

يمزج المستندات.

public void Merge(Document.MergeOptions mergeOptions, params Document[] documents)

Parameters

mergeOptions Document.MergeOptions

خيارات الدمج.

documents Document[]

المستندات للدمج.

Merge(MergeOptions, params string[])

يمزج المستندات.

public void Merge(Document.MergeOptions mergeOptions, params string[] files)

Parameters

mergeOptions Document.MergeOptions

خيارات الدمج.

files string[]

ملفات PDF للدمج.

Merge(params Document[])

يمزج المستندات.

public void Merge(params Document[] documents)

Parameters

documents Document[]

المستندات للدمج.

Merge(params string[])

يمزج ملفات PDF.

public void Merge(params string[] files)

Parameters

files string[]

ملفات PDF للدمج.

MergeDocuments(MergeOptions, params string[])

يمزج المستندات.

public static Document MergeDocuments(Document.MergeOptions mergeOptions, params string[] files)

Parameters

mergeOptions Document.MergeOptions

خيارات الدمج.

files string[]

ملفات PDF للدمج.

Returns

Document

المستند المدمج.

MergeDocuments(MergeOptions, params Document[])

يمزج المستندات.

public static Document MergeDocuments(Document.MergeOptions mergeOptions, params Document[] files)

Parameters

mergeOptions Document.MergeOptions

files Document[]

المستندات للدمج.

Returns

Document

المستند المدمج.

MergeDocuments(params string[])

يمزج ملفات PDF.

public static Document MergeDocuments(params string[] files)

Parameters

files string[]

ملفات PDF للدمج.

Returns

Document

المستند المدمج.

MergeDocuments(params Document[])

يمزج المستندات.

public static Document MergeDocuments(params Document[] documents)

Parameters

documents Document[]

المستندات للدمج.

Returns

Document

المستند المدمج.

Optimize()

يخطط المستند من أجل

• فتح الصفحة الأولى بأسرع ما يمكن؛
• عرض الصفحة التالية أو الانتقال إلى الرابط إلى الصفحة التالية بأسرع ما يمكن؛
• عرض الصفحة بشكل تدريجي عند وصول البيانات لصفحة ما عبر قناة بطيئة (عرض البيانات الأكثر فائدة أولاً)؛
• السماح بتفاعل المستخدم، مثل اتباع رابط، ليتم تنفيذه حتى قبل أن يتم استلام الصفحة بالكامل وعرضها. استدعاء هذه الطريقة لا يحفظ المستند فعليًا. على العكس، يتم فقط إعداد المستند ليكون له هيكل محسن، يجب بعد ذلك الاتصال بـ Save للحصول على مستند محسن.

public void Optimize()

OptimizeResources()

تحسين الموارد في المستند:

1. يتم إزالة الموارد التي لا تستخدم على صفحات المستند؛
2. يتم دمج الموارد المتساوية في كائن واحد؛
3. يتم حذف الكائنات غير المستخدمة.

public void OptimizeResources()

OptimizeResources(OptimizationOptions)

تحسين الموارد في المستند وفقًا لاستراتيجية التحسين المحددة.

public void OptimizeResources(OptimizationOptions strategy)

Parameters

strategy OptimizationOptions

استراتيجية التحسين.

PageNodesToBalancedTree(byte)

ينظم عقد شجرة الصفحة في المستند إلى شجرة متوازنة. فقط إذا كان المستند يحتوي على أكثر من nodesNumInSubtrees كائنات الصفحة، خلاف ذلك لا يفعل شيئًا. لا تستدعي هذه الطريقة أثناء التكرار على عناصر Pages، فقد تعطي نتائج غير متوقعة.

public void PageNodesToBalancedTree(byte nodesNumInSubtrees = 10)

Parameters

nodesNumInSubtrees byte

عدد العقد الفرعية المرغوب فيه. القيمة الافتراضية هي عشرة.

ProcessParagraphs()

معالجة الفقرات للمولد.

public void ProcessParagraphs()

RemoveMetadata()

يزيل بيانات التعريف من المستند.

public void RemoveMetadata()

RemovePdfUaCompliance()

يزيل التوافق مع PDF/UA من المستند.

public void RemovePdfUaCompliance()

RemovePdfaCompliance()

يزيل التوافق مع PDF/A من المستند.

public void RemovePdfaCompliance()

Repair()

يصلح المستند التالف.

public void Repair()

Save(Stream)

يخزن المستند في الدفق.

public void Save(Stream output)

Parameters

output Stream

دفق حيث سيتم تخزين المستند.

Save(string)

يحفظ المستند في الملف المحدد.

public void Save(string outputFileName)

Parameters

outputFileName string

المسار إلى الملف حيث سيتم تخزين المستند.

Save()

يحفظ المستند بشكل تزايدي (أي باستخدام تقنية التحديث التزايدي).

public void Save()

Remarks

من أجل حفظ المستند بشكل تزايدي، يجب فتح ملف المستند للكتابة. لذا، يجب تهيئة Document بدفق قابل للكتابة مثل في مقتطف الكود التالي: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // إجراء بعض التغييرات وحفظ المستند بشكل تزايدي doc.Save();

Save(SaveOptions)

يحفظ المستند مع خيارات الحفظ.

public void Save(SaveOptions options)

Parameters

options SaveOptions

خيارات الحفظ.

Save(string, SaveFormat)

يحفظ المستند باسم جديد مع تنسيق الملف.

public void Save(string outputFileName, SaveFormat format)

Parameters

outputFileName string

المسار إلى الملف حيث سيتم تخزين المستند.

format SaveFormat

خيارات التنسيق.

Save(Stream, SaveFormat)

يحفظ المستند باسم جديد مع تنسيق الملف.

public void Save(Stream outputStream, SaveFormat format)

Parameters

outputStream Stream

دفق حيث سيتم تخزين المستند.

format SaveFormat

خيارات التنسيق.

Exceptions

ArgumentException

System.ArgumentException عندما يتم تمرير Aspose.Pdf.HtmlSaveOptions إلى طريقة. حفظ المستند إلى دفق HTML غير مدعوم. يرجى استخدام طريقة الحفظ إلى الملف.

Save(string, SaveOptions)

يحفظ المستند باسم جديد مع تعيين خيارات الحفظ.

public void Save(string outputFileName, SaveOptions options)

Parameters

outputFileName string

المسار إلى الملف حيث سيتم تخزين المستند.

options SaveOptions

خيارات الحفظ.

Save(Stream, SaveOptions)

يحفظ المستند إلى دفق مع خيارات الحفظ.

public void Save(Stream outputStream, SaveOptions options)

Parameters

outputStream Stream

دفق حيث سيتم تخزين المستند.

options SaveOptions

خيارات الحفظ.

Exceptions

ArgumentException

System.ArgumentException عندما يتم تمرير Aspose.Pdf.HtmlSaveOptions إلى طريقة. حفظ المستند إلى دفق HTML غير مدعوم. يرجى استخدام طريقة الحفظ إلى الملف.

SaveAsync(Stream, CancellationToken)

يخزن المستند في الدفق.

public Task SaveAsync(Stream output, CancellationToken cancellationToken)

Parameters

output Stream

دفق حيث سيتم تخزين المستند.

cancellationToken CancellationToken

رمز إلغاء.

Returns

Task

مهمة غير متزامنة.

SaveAsync(string, CancellationToken)

يحفظ المستند في الملف المحدد.

public Task SaveAsync(string outputFileName, CancellationToken cancellationToken)

Parameters

outputFileName string

المسار إلى الملف حيث سيتم تخزين المستند.

cancellationToken CancellationToken

رمز إلغاء.

Returns

Task

مهمة غير متزامنة.

SaveAsync(CancellationToken)

يحفظ المستند بشكل تزايدي (أي باستخدام تقنية التحديث التزايدي).

public Task SaveAsync(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

رمز إلغاء.

Returns

Task

مهمة غير متزامنة.

Remarks

من أجل حفظ المستند بشكل تزايدي، يجب فتح ملف المستند للكتابة. لذا، يجب تهيئة Document بدفق قابل للكتابة مثل في مقتطف الكود التالي: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // إجراء بعض التغييرات وحفظ المستند بشكل تزايدي doc.Save();

SaveAsync(SaveOptions, CancellationToken)

يحفظ المستند مع خيارات الحفظ.

public Task SaveAsync(SaveOptions options, CancellationToken cancellationToken)

Parameters

options SaveOptions

خيارات الحفظ.

cancellationToken CancellationToken

رمز إلغاء.

Returns

Task

مهمة غير متزامنة.

SaveAsync(string, SaveFormat, CancellationToken)

يحفظ المستند باسم جديد مع تنسيق الملف.

public Task SaveAsync(string outputFileName, SaveFormat format, CancellationToken cancellationToken)

Parameters

outputFileName string

المسار إلى الملف حيث سيتم تخزين المستند.

format SaveFormat

خيارات التنسيق.

cancellationToken CancellationToken

رمز إلغاء.

Returns

Task

مهمة غير متزامنة.

SaveAsync(Stream, SaveFormat, CancellationToken)

يحفظ المستند باسم جديد مع تنسيق الملف.

public Task SaveAsync(Stream outputStream, SaveFormat format, CancellationToken cancellationToken)

Parameters

outputStream Stream

دفق حيث سيتم تخزين المستند.

format SaveFormat

خيارات التنسيق.

cancellationToken CancellationToken

رمز إلغاء.

Returns

Task

مهمة غير متزامنة.

Exceptions

ArgumentException

System.ArgumentException عندما يتم تمرير Aspose.Pdf.HtmlSaveOptions إلى طريقة. حفظ المستند إلى دفق HTML غير مدعوم. يرجى استخدام طريقة الحفظ إلى الملف.

SaveAsync(string, SaveOptions, CancellationToken)

يحفظ المستند باسم جديد مع تعيين خيارات الحفظ.

public Task SaveAsync(string outputFileName, SaveOptions options, CancellationToken cancellationToken)

Parameters

outputFileName string

المسار إلى الملف حيث سيتم تخزين المستند.

options SaveOptions

خيارات الحفظ.

cancellationToken CancellationToken

رمز إلغاء.

Returns

Task

مهمة غير متزامنة.

SaveAsync(Stream, SaveOptions, CancellationToken)

يحفظ المستند إلى دفق مع خيارات الحفظ.

public Task SaveAsync(Stream outputStream, SaveOptions options, CancellationToken cancellationToken)

Parameters

outputStream Stream

دفق حيث سيتم تخزين المستند.

options SaveOptions

خيارات الحفظ.

cancellationToken CancellationToken

رمز إلغاء.

Returns

Task

مهمة غير متزامنة.

Exceptions

ArgumentException

System.ArgumentException عندما يتم تمرير Aspose.Pdf.HtmlSaveOptions إلى طريقة. حفظ المستند إلى دفق HTML غير مدعوم. يرجى استخدام طريقة الحفظ إلى الملف.

SaveXml(string)

يحفظ المستند إلى XML.

public void SaveXml(string file)

Parameters

file string

نموذج ملف XML للمستند

SendTo(DocumentDevice, Stream)

يرسل المستند بالكامل إلى جهاز المستندات للمعالجة.

public void SendTo(DocumentDevice device, Stream output)

Parameters

device DocumentDevice

جهاز المستندات الذي يُستخدم لمعالجة المستند.

output Stream

دفق الإخراج يحتوي على نتائج معالجة المستند مع الجهاز المحدد.

SendTo(DocumentDevice, int, int, Stream)

يرسل الصفحات المحددة من المستند إلى جهاز المستندات للمعالجة.

public void SendTo(DocumentDevice device, int fromPage, int toPage, Stream output)

Parameters

device DocumentDevice

جهاز المستندات الذي يُستخدم لمعالجة المستند.

fromPage int

الصفحة الأولى للمعالجة.

toPage int

الصفحة الأخيرة للمعالجة.

output Stream

دفق الإخراج يحتوي على نتائج معالجة صفحات المستند مع الجهاز المحدد.

SendTo(DocumentDevice, string)

يرسل المستند بالكامل إلى جهاز المستندات للمعالجة.

public void SendTo(DocumentDevice device, string outputFileName)

Parameters

device DocumentDevice

جهاز المستندات الذي يُستخدم لمعالجة المستند.

outputFileName string

اسم ملف الإخراج مع نتائج المعالجة.

SendTo(DocumentDevice, int, int, string)

يرسل المستند بالكامل إلى جهاز المستندات للمعالجة.

public void SendTo(DocumentDevice device, int fromPage, int toPage, string outputFileName)

Parameters

device DocumentDevice

جهاز المستندات الذي يُستخدم لمعالجة المستند.

fromPage int

الصفحة الأولى للمعالجة.

toPage [int](https://learn.microsoft.com/dotnet/api/system