Document

نظرة عامة

Document هي فئة في Aspose.Words FOSS لـ .NET. تورث من: DocumentBase، ISectionAttrSource، IWatermarkProvider.

تتيح مُنشيئات فئة Document للمطورين إنشاء مستند جديد فارغ أو تحميل مستند موجود من مسار ملف، أو تدفق، أو باستخدام خيارات تحميل مخصصة.

توفر هذه الفئة 63 طريقة للعمل مع كائنات Document في برامج .NET. تشمل الطرق المتاحة: Accept، AcceptAllRevisions، AcceptEnd، AcceptStart، AppendChild، AppendDocument، Cleanup، Clone، CopyStylesFromTemplate، CreateNavigator، Document، EnsureMinimum، بالإضافة إلى 36 طريقة أخرى. جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.Words FOSS لـ .NET. الخصائص: AttachedTemplate، AutomaticallyUpdateStyles، BackgroundShape، Bibliography، BuiltInDocumentProperties، CompatibilityOptions، وأكثر من 62 خاصية أخرى.

خصائص

اسم	النوع	الوصول	وصف
`AttachedTemplate`	`string`	قراءة/كتابة	يحصل أو يضبط المسار الكامل للقالب المرفق بالمستند.
`AutomaticallyUpdateStyles`	`bool`	قراءة/كتابة	يحصل أو يضبط علامة تشير إلى ما إذا كانت الأنماط في المستند تُحدَّث لتطابق الأنماط في القالب المرفق في كل مرة يُفتح فيها المستند في برنامج MS Word.
`ShadeFormData`	`bool`	قراءة/كتابة	يحدد ما إذا كان سيتم تشغيل التظليل الرمادي على حقول النموذج.
`TrackRevisions`	`bool`	قراءة/كتابة	صحيح إذا تم تتبع التغييرات عندما يتم تعديل هذا المستند في Microsoft Word.
`ShowGrammaticalErrors`	`bool`	قراءة/كتابة	يحدد ما إذا كان سيتم عرض أخطاء القواعد في هذا المستند.
`ShowSpellingErrors`	`bool`	قراءة/كتابة	يحدد ما إذا كان سيتم عرض أخطاء الإملاء في هذا المستند.
`SpellingChecked`	`bool`	قراءة/كتابة	يعيد true إذا تم فحص المستند للتدقيق الإملائي.
`GrammarChecked`	`bool`	قراءة/كتابة	يعيد true إذا تم فحص المستند للتدقيق النحوي.
`PunctuationKerning`	`bool`	قراءة/كتابة	يحدد ما إذا كان kerning ينطبق على كل من النص اللاتيني وعلامات الترقيم.
`NodeType`	`NodeType`	قراءة	يعيد المستند.
`BuiltInDocumentProperties`	`BuiltInDocumentProperties`	قراءة	يعيد مجموعة تمثل جميع خصائص المستند المدمجة للمستند.
`WebExtensionTaskPanes`	`TaskPaneCollection`	قراءة	يعيد مجموعة تمثل قائمة إضافات لوحة المهام.
`CustomDocumentProperties`	`CustomDocumentProperties`	قراءة	يرجع مجموعة تمثل جميع خصائص المستند المخصصة للمستند.
`ProtectionType`	`ProtectionType`	قراءة	يحصل على نوع حماية المستند النشط حاليًا.
`Sections`	`SectionCollection`	قراءة	يُعيد مجموعة تمثل جميع الأقسام في المستند.
`FirstSection`	`Section`	قراءة	يحصل على القسم الأول في المستند.
`LastSection`	`Section`	قراءة	يحصل على القسم الأخير في المستند.
`ViewOptions`	`ViewOptions`	قراءة	يوفر خيارات للتحكم في كيفية عرض المستند في Microsoft Word.
`WriteProtection`	`WriteProtection`	قراءة	يوفر الوصول إلى خيارات حماية كتابة المستند.
`CompatibilityOptions`	`CompatibilityOptions`	قراءة	يوفر الوصول إلى خيارات توافق المستند (أي تفضيلات المستخدم المُدخلة في علامة تبويب Compatibility في مربع حوار Options في Word).
`MailMergeSettings`	`MailMergeSettings`	قراءة/كتابة	يحصل على أو يعيّن الكائن الذي يحتوي على جميع معلومات mail merge للمستند.
`HyphenationOptions`	`HyphenationOptions`	قراءة	يوفر الوصول إلى خيارات تجزئة المستند.
`HasRevisions`	`bool`	قراءة	يرجع true إذا كان المستند يحتوي على أي تغييرات متتبعة.
`HasMacros`	`bool`	قراءة	Returns true إذا كان المستند يحتوي على مشروع VBA (macros).
`Watermark`	`Watermark`	قراءة	يوفر الوصول إلى علامة مائية المستند.
`VersionsCount`	`int`	قراءة	يحصل على عدد إصدارات المستند التي تم تخزينها في مستند DOC.
`DefaultTabStop`	`double`	قراءة/كتابة	يحصل أو يضبط الفاصل (بالنقاط) بين نقاط التبويب الافتراضية.
`Theme`	`Theme`	قراءة	يحصل على كائن `Theme` لهذا المستند.
`CustomXmlParts`	`CustomXmlPartCollection`	قراءة/كتابة	يحصل أو يعيّن مجموعة أجزاء تخزين البيانات المخصصة XML.
`PackageCustomParts`	`CustomPartCollection`	قراءة/كتابة	يحصل أو يعيّن مجموعة الأجزاء المخصصة (محتوى تعسفي) المرتبطة بحزمة OOXML باستخدام “unknown relationships”.
`Variables`	`VariableCollection`	قراءة	يعيد مجموعة المتغيّرات المضافة إلى مستند أو قالب.
`GlossaryDocument`	`GlossaryDocument`	قراءة/كتابة	يحصل أو يعيّن مستند القاموس داخل هذا المستند أو القالب.
`OriginalFileName`	`string`	قراءة	يحصل على اسم الملف الأصلي للمستند.
`OriginalLoadFormat`	`LoadFormat`	قراءة	يحصل على تنسيق المستند الأصلي الذي تم تحميله إلى هذا الكائن.
`Compliance`	`OoxmlCompliance`	قراءة	يحصل على نسخة التوافق مع OOXML المحددة من محتوى المستند المحمَّل.
`DigitalSignatures`	`DigitalSignatureCollection`	قراءة	يحصل على مجموعة التوقيعات الرقمية لهذا المستند ونتائج التحقق منها.
`FontSettings`	`FontSettings`	قراءة/كتابة	يحصل أو يضبط إعدادات خط المستند.
`Bibliography`	`Bibliography.Bibliography`	قراءة	يحصل على كائن Bibliography الذي يمثل قائمة المصادر المتاحة في المستند.
`Frameset`	`Frameset`	قراءة	يعيد مثيل Frameset إذا كان هذا المستند يمثل صفحة إطارات.
`IncludeTextboxesFootnotesEndnotesInStat`	`bool`	قراءة/كتابة	يحدد ما إذا كان يجب تضمين textboxes و footnotes و endnotes في إحصاءات عدد الكلمات.
`Revisions`	`RevisionCollection`	قراءة	يحصل على مجموعة من المراجعات (التغييرات المتعقبة) الموجودة في هذا المستند.
`RevisionsView`	`RevisionsView`	قراءة/كتابة	يحصل على أو يعيّن قيمة تشير إلى ما إذا كان سيتم العمل مع النسخة الأصلية أو النسخة المعدلة من المستند.
`JustificationMode`	`JustificationMode`	قراءة/كتابة	يحصل أو يعيّن تعديل تباعد الأحرف في المستند.
`FootnoteOptions`	`FootnoteOptions`	قراءة	يوفر خيارات تتحكم في ترقيم وتحديد موضع الحواشي السفلية في هذا المستند.
`EndnoteOptions`	`EndnoteOptions`	قراءة	يوفر خيارات تتحكم في ترقيم وتحديد موضع الحواشي الختامية في هذا المستند.
`FieldOptions`	`FieldOptions`	قراءة	يحصل على كائن FieldOptions يمثل خيارات للتحكم في معالجة الحقول في المستند.
`RemovePersonalInformation`	`bool`	قراءة/كتابة	يحصل أو يضبط علامة تشير إلى أن Microsoft Word سيزيل جميع معلومات المستخدم من التعليقات، والتعديلات، وخصائص المستند عند حفظ المستند.
`VbaProject`	`VbaProject`	قراءة/كتابة	يحصل أو يعيّن VbaProject.
`Document`	`DocumentBase`	قراءة	يحصل على هذا المثيل.
`NodeChangingCallback`	`INodeChangingCallback`	قراءة/كتابة	يُستدعى عندما يتم إدراج عقدة أو إزالتها في المستند.
`ResourceLoadingCallback`	`IResourceLoadingCallback`	قراءة/كتابة	يسمح بالتحكم في طريقة تحميل الموارد الخارجية.
`FontInfos`	`FontInfoCollection`	قراءة	يوفر الوصول إلى خصائص الخطوط المستخدمة في هذا المستند.
`Styles`	`StyleCollection`	قراءة	يُرجِع مجموعة من الأنماط المعرفة في المستند.
`Lists`	`ListCollection`	قراءة	يُوفِّر الوصول إلى تنسيق القوائم المستخدم في المستند.
`WarningCallback`	`IWarningCallback`	قراءة/كتابة	يُستدعى أثناء إجراءات معالجة المستند المتنوعة عندما يتم اكتشاف مشكلة قد تؤدي إلى فقدان الدقة في البيانات أو التنسيق.
`FootnoteSeparators`	`FootnoteSeparatorCollection`	قراءة	يتيح الوصول إلى فواصل الحواشي/الحواشي النهائية المعرفة في المستند.
`BackgroundShape`	`Shape`	قراءة/كتابة	يحصل أو يضبط الشكل الخلفي للمستند.
`PageColor`	`Color`	قراءة/كتابة	يسترجع أو يعيّن لون الصفحة للمستند.
`IsComposite`	`bool`	قراءة	يعيد true لأن هذه العقدة يمكن أن تحتوي على عقد فرعية.
`HasChildNodes`	`bool`	قراءة	تُعيد true إذا كان لهذا node أي child nodes.
`FirstChild`	`Node`	قراءة	يحصل على الطفل الأول للعقدة.
`LastChild`	`Node`	قراءة	يحصل على العنصر الفرعي الأخير للعقدة.
`Count`	`int`	قراءة	يحصل على عدد الأطفال المباشرين لهذه العقدة.
`ParentNode`	`CompositeNode`	قراءة	يحصل على الوالد الفوري لهذه العقدة.
`PreviousSibling`	`Node`	قراءة	يحصل على العقدة التي تسبق هذه العقدة مباشرةً.
`NextSibling`	`Node`	قراءة	يسترجع العقدة التي تتبع هذه العقدة مباشرةً.
`Range`	`Range`	قراءة	يرجع كائن Range يُمثّل الجزء من المستند الموجود داخل هذه العقدة.
`CustomNodeId`	`int`	قراءة/كتابة	يحدد معرف العقدة المخصص.

الطرق

التوقيع	وصف
`Document()`	ينشئ أو يحمل مستندًا.
`Document(fileName: string)`	يفتح مستندًا موجودًا من ملف.
`Document(fileName: string, loadOptions: LoadOptions)`	يفتح مستندًا موجودًا من ملف.
`Document(stream: Stream)`	يستدعي Document(stream) على هذا كائن Document.
`Document(stream: Stream, loadOptions: LoadOptions)`	ينفّذ استدعاء Document(stream, loadOptions) على هذه المثيلة من Document.
`Clone()`	يُنفّذ نسخة عميقة من الـ Document.
`Accept(visitor: DocumentVisitor)`	يستدعي VisitDocumentStart، ثم يستدعي Accept لجميع العقد الفرعية للمستند ويستدعي VisitDocumentEnd في النهاية.
`AcceptStart(visitor: DocumentVisitor)`	يقبل زائرًا لزيارة بداية المستند.
`AcceptEnd(visitor: DocumentVisitor)`	يقبل زائرًا لزيارة نهاية المستند.
`AppendDocument(srcDoc: Document, importFormatMode: ImportFormatMode)`	يضيف المستند المحدد إلى نهاية هذا المستند.
`AppendDocument(srcDoc: Document, importFormatMode: ImportFormatMode, importFormatOptions: ImportFormatOptions)`	يُضيف المستند المحدد إلى نهاية هذا المستند.
`Save(fileName: string)`	يحفظ المستند.
`Save(fileName: string, saveFormat: SaveFormat)`	يحفظ المستند في ملف بالتنسيق المحدد.
`Save(fileName: string, saveOptions: SaveOptions)`	يحفظ المستند في ملف باستخدام خيارات الحفظ المحددة.
`Save(stream: Stream, saveFormat: SaveFormat)`	Overloads تمكن من حفظ مستند إلى اسم ملف أو إلى تدفق، مع إمكانية تحديد تنسيق الحفظ أو خيارات الحفظ التفصيلية
`Save(stream: Stream, saveOptions: SaveOptions)`	يستدعي Save(stream, saveOptions) على هذه المثيلة من Document.
`Save(response: HttpResponse, fileName: string, contentDisposition: ContentDisposition, saveOptions: SaveOptions)`	يرسل المستند إلى متصفح العميل.
`EnsureMinimum()`	إذا كان المستند لا يحتوي على أقسام، ينشئ قسماً واحداً بفقرة واحدة.
`AcceptAllRevisions()`	يقبل جميع التغييرات المتتبعة في المستند.
`Protect(type: ProtectionType)`	يحمي المستند من التغييرات.
`Protect(type: ProtectionType, password: string)`	يحمي المستند من التغييرات ويُعيّن كلمة مرور الحماية اختياريًا.
`Unprotect()`	يزيل الحماية من المستند.
`Unprotect(password: string)`	يزيل الحماية من المستند إذا تم تحديد كلمة مرور صحيحة.
`UpdateTableLayout()`	يُطبق نهجًا سابقًا لإعادة حساب عرض أعمدة الجدول الذي يحتوي على مشكلات معروفة.
`UpdateListLabels()`	يقوم بتحديث تسميات القوائم لجميع عناصر القائمة في المستند.
`UpdateActualReferenceMarks()`	يقوم بتحديث خاصية ActualReferenceMark لجميع الحواشي السفلية والحواشي النهائية في المستند.
`RemoveMacros()`	يزيل جميع الماكرو (مشروع VBA) وكذلك أشرطة الأدوات وتخصيصات الأوامر من المستند.
`UpdateFields()`	يُحدّث قيم الحقول في المستند بأكمله.
`UnlinkFields()`	يفك ربط الحقول في المستند بأكمله.
`NormalizeFieldTypes()`	يغيّر قيم نوع الحقل FieldType لـ FieldStart، FieldSeparator، FieldEnd في المستند بأكمله بحيث تتطابق مع أنواع الحقول الموجودة في رموز الحقول.
`JoinRunsWithSameFormatting()`	يجمع المقاطع ذات التنسيق نفسه في جميع الفقرات في المستند.
`ExpandTableStylesToDirectFormatting()`	يحوّل التنسيق المحدد في أنماط الجداول إلى تنسيق مباشر على الجداول في المستند.
`Cleanup()`	ينظف الأنماط والقوائم غير المستخدمة من المستند.
`Cleanup(options: CleanupOptions)`	ينظف الأنماط والقوائم غير المستخدمة من المستند بناءً على CleanupOptions المحدد.
`RemoveExternalSchemaReferences()`	يزيل مراجع مخطط XML الخارجية من هذا المستند.
`StartTrackRevisions(author: string, dateTime: DateTime)`	يبدأ تلقائيًا في وضع علامة على جميع التغييرات اللاحقة التي تجريها على المستند برمجيًا كتغييرات مراجعة.
`StartTrackRevisions(author: string)`	يبدأ تلقائيًا في وضع علامة على جميع التغييرات اللاحقة التي تقوم بها على المستند برمجيًا باعتبارها تغييرات مراجعة.
`StopTrackRevisions()`	يتوقف عن وضع علامة تلقائية على تغييرات المستند باعتبارها مراجعات.
`CopyStylesFromTemplate(template: string)`	ينسخ الأنماط من القالب المحدد إلى مستند.
`CopyStylesFromTemplate(template: Document)`	ينسخ الأنماط من القالب المحدد إلى مستند.
`ImportNode(srcNode: Node, isImportChildren: bool)`	يستورد عقدة من مستند آخر إلى المستند الحالي.
`GetText()`	يحصل على نص هذه العقدة وجميع أبنائها.
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	يرجع مجموعة من العقد الفرعية التي تطابق النوع المحدد.
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	يرجع العقدة الفرعية رقم N التي تطابق النوع المحدد.
`SelectNodes(xpath: string)`	يختار قائمة من العقد التي تطابق تعبير XPath.
`SelectSingleNode(xpath: string)`	يختار أول Node يطابق تعبير XPath.
`GetEnumerator()`	يوفر دعمًا للتكرار بنمط for each على العقد الفرعية لهذه العقدة.
`AppendChild(newChild: T)`	يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذا العقد.
`PrependChild(newChild: T)`	يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذا العقد.
`InsertAfter(newChild: T, refChild: Node)`	يدرج العقدة المحددة مباشرةً بعد العقدة المرجعية المحددة.
`InsertBefore(newChild: T, refChild: Node)`	يدرج العقدة المحددة مباشرةً قبل العقدة المرجعية المحددة.
`RemoveChild(oldChild: T)`	يزيل العقدة الفرعية المحددة.
`RemoveAllChildren()`	يزيل جميع العقد الفرعية للعقدة الحالية.
`RemoveSmartTags()`	يزيل جميع العقد السليلية SmartTag للعقدة الحالية.
`IndexOf(child: Node)`	يرجع الفهرس الخاص بالعقدة الفرعية المحددة في مصفوفة العقد الفرعية.
`CreateNavigator()`	ينشئ مستكشفًا يمكن استخدامه لتجوال وقراءة العقد.
`GetAncestor(ancestorType: Type)`	يحصل على السلف الأول من نوع الكائن المحدد.
`GetAncestorOf()`	يستدعي GetAncestorOf على كائن Document هذا.
`Remove()`	يزيل نفسه من العنصر الأب.
`NextPreOrder(rootNode: Node)`	يحصل على العقدة التالية وفقًا لخوارزمية التجول المسبق للشجرة.
`PreviousPreOrder(rootNode: Node)`	يحصل على العقدة السابقة وفقًا لخوارزمية التجول المسبق للشجرة.
`ToString(saveFormat: SaveFormat)`	يصدّر محتوى العقدة إلى سلسلة نصية بالتنسيق المحدد.
`NodeTypeToString(nodeType: NodeType)`	طريقة مساعدة تقوم بتحويل قيمة تعداد نوع العقدة إلى سلسلة نصية سهلة الفهم للمستخدم.

انظر أيضاً

Aspose.Words for .NET — Enterprise API Reference