Document

Document class

يمثل مستند Word.

لمعرفة المزيد، قم بزيارةالعمل مع المستند مقالة توثيقية.

public class Document : DocumentBase

المنشئون

اسموصف
Document()ينشئ مستند Word فارغًا.
Document(Stream)يفتح مستندًا موجودًا من مصدر. يكتشف تنسيق الملف تلقائيًا.
Document(string)يفتح مستندًا موجودًا من ملف. يكتشف تنسيق الملف تلقائيًا.
Document(Stream, LoadOptions)يفتح مستندًا موجودًا من مصدر. يسمح بتحديد خيارات إضافية، مثل كلمة مرور التشفير.
Document(string, LoadOptions)يفتح مستندًا موجودًا من ملف. يسمح بتحديد خيارات إضافية، مثل كلمة مرور التشفير.

الخصائص

اسموصف
AttachedTemplate { get; set; }يحصل على المسار الكامل للقالب المرفق بالمستند أو يعينه.
AutomaticallyUpdateStyles { get; set; }يحصل على علم أو يعينه للإشارة إلى ما إذا كانت الأنماط في المستند يتم تحديثها لتتوافق مع الأنماط الموجودة في القالب المرفق في كل مرة يتم فيها فتح المستند في MS Word.
BackgroundShape { get; set; }يحصل على شكل خلفية المستند أو يضبطه. يمكن استخدامهباطل .
Bibliography { get; }يحصل علىBibliographyالكائن الذي يمثل قائمة المصادر المتوفرة في المستند.
BuiltInDocumentProperties { get; }يعيد مجموعة تمثل جميع خصائص المستند المضمنة.
CompatibilityOptions { get; }يوفر الوصول إلى خيارات توافق المستندات (أي تفضيلات المستخدم المدخلة علىالتوافق علامة التبويب منخياراتالحوار في Word).
Compliance { get; }يحصل على إصدار التوافق مع OOXML المحدد من محتوى المستند المحمّل. يكون منطقيًا فقط بالنسبة لمستندات OOXML.
Count { get; }يحصل على عدد الأبناء المباشرين لهذه العقدة.
CustomDocumentProperties { get; }يعيد مجموعة تمثل جميع خصائص المستند المخصصة للمستند.
CustomNodeId { get; set; }يحدد معرف العقدة المخصص.
CustomXmlParts { get; set; }يحصل على مجموعة أجزاء تخزين بيانات XML المخصصة أو يعينها.
DefaultTabStop { get; set; }يحصل على الفاصل الزمني (بالنقاط) بين علامات التبويب الافتراضية أو يعينه.
DigitalSignatures { get; }يحصل على مجموعة التوقيعات الرقمية لهذه الوثيقة ونتائج التحقق منها.
override Document { get; }يحصل على هذه المثيل.
EndnoteOptions { get; }يوفر خيارات للتحكم في ترقيم وموضع الحواشي الختامية في هذا المستند.
FieldOptions { get; }يحصل علىFieldOptions كائن يمثل خيارات للتحكم في التعامل مع الحقول في المستند.
FirstChild { get; }يحصل على أول طفل للعقدة.
FirstSection { get; }يحصل على القسم الأول في المستند.
FontInfos { get; }يوفر الوصول إلى خصائص الخطوط المستخدمة في هذه الوثيقة.
FontSettings { get; set; }يحصل على إعدادات خط المستند أو يعينها.
FootnoteOptions { get; }يوفر خيارات للتحكم في ترقيم الحواشي السفلية وتحديد موقعها في هذا المستند.
FootnoteSeparators { get; }يوفر الوصول إلى فواصل الحواشي السفلية/النهائية المحددة في المستند.
Frameset { get; }يعيدFrameset مثال إذا كانت هذه الوثيقة تمثل صفحة إطارات.
GlossaryDocument { get; set; }يحصل على أو يعيّن مستند المصطلحات داخل هذا المستند أو القالب. مستند المصطلحات هو مخزن لإدخالات النص التلقائي والتصحيح التلقائي وكتل البناء المحددة في مستند.
GrammarChecked { get; set; }إرجاعحقيقي إذا تم التحقق من القواعد النحوية للمستند.
HasChildNodes { get; }إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية.
HasMacros { get; }إرجاعحقيقي إذا كان المستند يحتوي على مشروع VBA (ماكرو).
HasRevisions { get; }إرجاعحقيقي إذا كان المستند يحتوي على أي تغييرات متعقبة.
HyphenationOptions { get; }يوفر الوصول إلى خيارات وضع علامات الوصل في المستند.
IncludeTextboxesFootnotesEndnotesInStat { get; set; }يحدد ما إذا كان سيتم تضمين مربعات النص والحواشي السفلية والختامية في إحصائيات عدد الكلمات.
override IsComposite { get; }إرجاعحقيقي حيث يمكن لهذه العقدة أن تحتوي على عقد فرعية.
JustificationMode { get; set; }يحصل على تعديل المسافة بين أحرف المستند أو يعينه.
LastChild { get; }يحصل على آخر طفل للعقدة.
LastSection { get; }يحصل على القسم الأخير في المستند.
LayoutOptions { get; }يحصل علىLayoutOptions الكائن الذي يمثل الخيارات للتحكم في عملية تخطيط هذا المستند.
Lists { get; }يوفر الوصول إلى تنسيق القائمة المستخدم في المستند.
MailMerge { get; }يعيدMailMerge الكائن الذي يمثل وظيفة دمج البريد للمستند.
MailMergeSettings { get; set; }يحصل على الكائن الذي يحتوي على كافة معلومات دمج البريد لمستند أو يعينه.
NextSibling { get; }يحصل على العقدة التي تلي هذه العقدة مباشرة.
NodeChangingCallback { get; set; }يتم استدعاؤها عند إدراج عقدة أو إزالتها في المستند.
override NodeType { get; }إرجاعDocument .
OriginalFileName { get; }يحصل على اسم الملف الأصلي للمستند.
OriginalLoadFormat { get; }يحصل على تنسيق المستند الأصلي الذي تم تحميله في هذا الكائن.
PackageCustomParts { get; set; }يحصل على مجموعة الأجزاء المخصصة (المحتوى التعسفي) المرتبطة بحزمة OOXML باستخدام “علاقات غير معروفة” أو يعينها.
PageColor { get; set; }يُحدِّد لون صفحة المستند أو يُحدِّده. هذه الخاصية هي نسخة أبسط منBackgroundShape .
PageCount { get; }يحصل على عدد الصفحات في المستند كما تم حسابه بواسطة عملية تخطيط الصفحة الأخيرة.
ParentNode { get; }يحصل على الوالد المباشر لهذه العقدة.
PreviousSibling { get; }يحصل على العقدة التي تسبق هذه العقدة مباشرةً.
ProtectionType { get; }يحصل على نوع حماية المستند النشط حاليًا.
PunctuationKerning { get; set; }يحدد ما إذا كان التباعد بين الأحرف ينطبق على كل من النص اللاتيني وعلامات الترقيم.
Range { get; }يعيدRangeالكائن الذي يمثل الجزء من المستند الموجود في هذه العقدة.
RemovePersonalInformation { get; set; }يحصل على أو يعين علمًا يشير إلى أن Microsoft Word سيقوم بإزالة جميع معلومات المستخدم من التعليقات والمراجعات وخصائص المستند عند حفظ المستند.
ResourceLoadingCallback { get; set; }يسمح بالتحكم في كيفية تحميل الموارد الخارجية.
Revisions { get; }يحصل على مجموعة من المراجعات (التغييرات المتعقبة) الموجودة في هذا المستند.
RevisionsView { get; set; }يحصل على قيمة أو يعينها للإشارة إلى ما إذا كان سيتم العمل مع الإصدار الأصلي أو المنقح للمستند.
Sections { get; }يعيد مجموعة تمثل جميع الأقسام في المستند.
ShadeFormData { get; set; }يحدد ما إذا كان سيتم تشغيل التظليل الرمادي على حقول النموذج.
ShowGrammaticalErrors { get; set; }يحدد ما إذا كان سيتم عرض أخطاء القواعد النحوية في هذا المستند.
ShowSpellingErrors { get; set; }يحدد ما إذا كان سيتم عرض الأخطاء الإملائية في هذا المستند.
SpellingChecked { get; set; }إرجاعحقيقي إذا تم التحقق من صحة التهجئة في المستند.
Styles { get; }يعيد مجموعة من الأنماط المحددة في المستند.
Theme { get; }يحصل علىTheme كائن لهذه الوثيقة.
TrackRevisions { get; set; }صحيح إذا تم تعقب التغييرات عند تحرير هذا المستند في Microsoft Word.
Variables { get; }يعيد مجموعة المتغيرات المضافة إلى مستند أو قالب.
VbaProject { get; set; }يحصل على أو يعينVbaProject .
VersionsCount { get; }يحصل على عدد إصدارات المستند التي تم تخزينها في مستند DOC.
ViewOptions { get; }يوفر خيارات للتحكم في كيفية عرض المستند في Microsoft Word.
WarningCallback { get; set; }يتم استدعاؤها أثناء إجراءات معالجة المستندات المختلفة عند اكتشاف مشكلة قد تؤدي إلى فقدان دقة البيانات أو التنسيق.
Watermark { get; }يوفر الوصول إلى العلامة المائية للمستند.
WebExtensionTaskPanes { get; }يعيد مجموعة تمثل قائمة من الوظائف الإضافية لجزء المهام.
WriteProtection { get; }يوفر الوصول إلى خيارات حماية الكتابة في المستند.

طُرق

اسموصف
override Accept(DocumentVisitor)يقبل زائرًا.
AcceptAllRevisions()يقبل جميع التغييرات المتعقبة في المستند.
override AcceptEnd(DocumentVisitor)يقبل الزائر لزيارة نهاية المستند.
override AcceptStart(DocumentVisitor)يقبل الزائر لزيارة بداية المستند.
AppendChild<T>(T)يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة.
AppendDocument(Document, ImportFormatMode)يضيف المستند المحدد إلى نهاية هذا المستند.
AppendDocument(Document, ImportFormatModeImportFormatOptions)يضيف المستند المحدد إلى نهاية هذا المستند.
Cleanup()ينظف الأنماط والقوائم غير المستخدمة من المستند.
Cleanup(CleanupOptions)ينظف الأنماط والقوائم غير المستخدمة من المستند بناءً على ما تم تقديمهCleanupOptions .
Clone()يقوم بإجراء نسخة عميقة منDocument .
Clone(bool)ينشئ نسخة مكررة من العقدة.
Compare(Document, string, DateTime)يقارن هذا المستند بمستند آخر وينتج تغييرات حسب عدد عمليات التحرير والتنسيقRevision .
Compare(Document, string, DateTime, CompareOptions)يقارن هذا المستند بمستند آخر وينتج تغييرات نتيجة لعدد من عمليات التحرير والتنسيقRevision . يسمح بتحديد خيارات المقارنة باستخدامCompareOptions .
CopyStylesFromTemplate(Document)نسخ الأنماط من القالب المحدد إلى مستند.
CopyStylesFromTemplate(string)نسخ الأنماط من القالب المحدد إلى مستند.
CreateNavigator()ينشئ متصفحًا يمكن استخدامه للتنقل بين العقد وقراءتها.
EnsureMinimum()إذا لم تحتوي الوثيقة على أي أقسام، فسيتم إنشاء قسم واحد يحتوي على فقرة واحدة.
ExpandTableStylesToDirectFormatting()يحول التنسيق المحدد في أنماط الجدول إلى تنسيق مباشر على الجداول في المستند.
ExtractPages(int, int)يعيدDocument كائن يمثل نطاقًا محددًا من الصفحات.
GetAncestor(NodeType)يحصل على السلف الأول للعنصر المحددNodeType .
GetAncestor(Type)يحصل على السلف الأول لنوع الكائن المحدد.
GetChild(NodeType, int, bool)يعيد عقدة فرعية رقم N تطابق النوع المحدد.
GetChildNodes(NodeType, bool)يعيد مجموعة حية من العقد الفرعية التي تطابق النوع المحدد.
GetEnumerator()يوفر الدعم لكل تكرار للأسلوب على العقد الفرعية لهذه العقدة.
GetPageInfo(int)يحصل على حجم الصفحة والاتجاه ومعلومات أخرى حول الصفحة التي قد تكون مفيدة للطباعة أو العرض.
override GetText()يحصل على نص هذه العقدة وجميع أبنائها.
ImportNode(Node, bool)استيراد عقدة من مستند آخر إلى المستند الحالي.
ImportNode(Node, bool, ImportFormatMode)استيراد عقدة من مستند آخر إلى المستند الحالي مع خيار التحكم في التنسيق.
IndexOf(Node)يعيد مؤشر العقدة الفرعية المحددة في مجموعة العقد الفرعية.
InsertAfter<T>(T, Node)يقوم بإدراج العقدة المحددة فورًا بعد عقدة المرجع المحددة.
InsertBefore<T>(T, Node)يقوم بإدراج العقدة المحددة مباشرة قبل عقدة المرجع المحددة.
JoinRunsWithSameFormatting()ينضم إلى التشغيلات بنفس التنسيق في جميع فقرات المستند.
NextPreOrder(Node)يحصل على العقدة التالية وفقًا لخوارزمية عبور شجرة الترتيب المسبق.
NormalizeFieldTypes()تغيير قيم نوع الحقلFieldType لFieldStart ،FieldSeparator ،FieldEnd في المستند بأكمله بحيث تتوافق مع أنواع الحقول الموجودة في رموز الحقول.
PrependChild<T>(T)يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذه العقدة.
PreviousPreOrder(Node)يحصل على العقدة السابقة وفقًا لخوارزمية عبور شجرة الترتيب المسبق.
Print()يطبع المستند بأكمله على الطابعة الافتراضية.
Print(PrinterSettings)يطبع المستند وفقًا لإعدادات الطابعة المحددة، باستخدام وحدة التحكم في الطباعة القياسية (بدون واجهة مستخدم).
Print(string)اطبع المستند بأكمله على الطابعة المحددة، باستخدام وحدة التحكم في الطباعة القياسية (بدون واجهة مستخدم).
Print(PrinterSettings, string)يطبع المستند وفقًا لإعدادات الطابعة المحددة، باستخدام وحدة التحكم في الطباعة القياسية (بدون واجهة مستخدم) واسم المستند.
Protect(ProtectionType)يحمي المستند من التغييرات دون تغيير كلمة المرور الموجودة أو تعيين كلمة مرور عشوائية.
Protect(ProtectionType, string)يحمي المستند من التغييرات ويحدد بشكل اختياري كلمة مرور للحماية.
Remove()يزيل نفسه من الأصل.
RemoveAllChildren()يزيل جميع العقد الفرعية للعقدة الحالية.
RemoveBlankPages()يزيل الصفحات الفارغة من المستند.
RemoveChild<T>(T)يزيل العقدة الفرعية المحددة.
RemoveExternalSchemaReferences()يزيل مراجع مخطط XML الخارجية من هذه الوثيقة.
RemoveMacros()يزيل جميع وحدات الماكرو (مشروع VBA) بالإضافة إلى أشرطة الأدوات وتخصيصات الأوامر من المستند.
RemoveSmartTags()يزيل الكلSmartTag العقد المنحدرة من العقدة الحالية.
RenderToScale(int, Graphics, float, float, float)يعرض صفحة مستند فيGraphics الكائن إلى مقياس محدد.
RenderToSize(int, Graphics, float, float, float, float)يعرض صفحة مستند فيGraphics الكائن إلى حجم محدد.
Save(string)يحفظ المستند في ملف. يحدد تلقائيًا تنسيق الحفظ من الامتداد.
Save(Stream, SaveFormat)يحفظ المستند في مجرى باستخدام التنسيق المحدد.
Save(Stream, SaveOptions)يحفظ المستند في مجرى باستخدام خيارات الحفظ المحددة.
Save(string, SaveFormat)يحفظ المستند في ملف بالتنسيق المحدد.
Save(string, SaveOptions)يحفظ المستند في ملف باستخدام خيارات الحفظ المحددة.
Save(HttpResponse, string, ContentDispositionSaveOptions)يرسل المستند إلى متصفح العميل.
SelectNodes(string)يحدد قائمة العقد المطابقة لتعبير XPath.
SelectSingleNode(string)يحدد الأولNode الذي يتطابق مع تعبير XPath.
StartTrackRevisions(string)يبدأ تلقائيًا بوضع علامة على جميع التغييرات الإضافية التي تقوم بها على المستند برمجيًا باعتبارها تغييرات مراجعة.
StartTrackRevisions(string, DateTime)يبدأ تلقائيًا بوضع علامة على جميع التغييرات الإضافية التي تقوم بها على المستند برمجيًا باعتبارها تغييرات مراجعة.
StopTrackRevisions()يوقف وضع علامة تلقائية على تغييرات المستند باعتبارها مراجعات.
ToString(SaveFormat)يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد.
ToString(SaveOptions)يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة.
UnlinkFields()إلغاء ربط الحقول في المستند بأكمله.
Unprotect()يزيل الحماية من المستند بغض النظر عن كلمة المرور.
Unprotect(string)يزيل الحماية من المستند إذا تم تحديد كلمة مرور صحيحة.
UpdateActualReferenceMarks()تحديثActualReferenceMark خاصية جميع الحواشي السفلية والختامية في المستند.
UpdateFields()تحديث قيم الحقول في المستند بأكمله.
UpdateListLabels()تحديث تسميات القائمة لجميع عناصر القائمة في المستند.
UpdatePageLayout()إعادة بناء تخطيط الصفحة للمستند.
UpdateThumbnail()تحديثات Thumbnail من المستند باستخدام الخيارات الافتراضية.
UpdateThumbnail(ThumbnailGeneratingOptions)تحديثات Thumbnail من المستند وفقًا للخيارات المحددة.
UpdateWordCount()تحديث خصائص عدد الكلمات في المستند.
UpdateWordCount(bool)تحديث خصائص عدد الكلمات في المستند، ويتم التحديث بشكل اختياريLines الملكية.

ملاحظات

الDocument هو كائن مركزي في مكتبة Aspose.Words.

لتحميل مستند موجود في أي منLoadFormat التنسيقات، مرر اسم الملف أو مجرى إلى أحدDocument المنشئون. لإنشاء مستند فارغ، اتصل بالمنشئ بدون معلمات.

استخدم إحدى عمليات التحميل الزائد لطريقة الحفظ لحفظ المستند في أي من ملفات SaveFormat التنسيقات.

لرسم صفحات المستند مباشرة علىالرسومات كائن الاستخدام RenderToScale أوRenderToSize طريقة.

لطباعة المستند، استخدم أحدPrint طُرق.

MailMergeهو محرك إعداد التقارير الخاص بـ Aspose.Words الذي يسمح بملء التقارير المصممة في Microsoft Word بالبيانات من مصادر بيانات مختلفة بسرعة وسهولة. يمكن أن تكون البيانات من DataSet أو DataTable أو DataView أو IDataReader أو مجموعة من القيم.دمج البريد سيقوم بفحص السجلات الموجودة في مصدر البيانات وإدراجها في حقول دمج البريد في المستند وتنميتها حسب الضرورة.

Document يخزن معلومات على مستوى المستند مثلStyles ، BuiltInDocumentProperties ،CustomDocumentProperties ، القوائم والماكرو. يمكن الوصول إلى معظم هذه الكائنات عبر الخصائص المقابلة لـDocument.

الDocument هي عقدة جذرية لشجرة تحتوي على جميع العقد الأخرى للمستند. الشجرة عبارة عن نمط تصميم مركب ومشابهة لـ XmlDocument في كثير من النواحي. يمكن معالجة محتوى المستند بحرية برمجيًا:

  • يمكن الوصول إلى عقد المستند عبر المجموعات المكتوبة، على سبيل المثالSections ، ParagraphCollection إلخ.
  • يمكن تحديد عقد المستند حسب نوع العقدة باستخدام GetChildNodes أو باستخدام استعلام XPath معSelectNodes أوSelectSingleNode.
  • يمكن إضافة عقد المحتوى أو إزالتها من أي مكان في المستند باستخدام InsertBefore ،InsertAfter ، RemoveChild وطرق other التي توفرها الفئة الأساسيةCompositeNode.
  • يمكن تغيير سمات التنسيق لكل عقدة عبر خصائص تلك العقدة.

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

الDocument يمكن أن تحتوي فقطSection أشياء.

في Microsoft Word، يجب أن يحتوي المستند الصحيح على قسم واحد على الأقل.

أمثلة

يوضح كيفية تنفيذ دمج البريد باستخدام البيانات من جدول البيانات.

public void ExecuteDataTable()
{
    DataTable table = new DataTable("Test");
    table.Columns.Add("CustomerName");
    table.Columns.Add("Address");
    table.Rows.Add(new object[] { "Thomas Hardy", "120 Hanover Sq., London" });
    table.Rows.Add(new object[] { "Paolo Accorti", "Via Monte Bianco 34, Torino" });

    // فيما يلي طريقتان لاستخدام جدول البيانات كمصدر بيانات لدمج البريد.
    // 1 - استخدم الجدول بأكمله لدمج البريد لإنشاء مستند دمج بريدي واحد لكل صف في الجدول:
    Document doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.WholeTable.docx");

    // 2 - استخدم صفًا واحدًا من الجدول لإنشاء مستند دمج بريدي واحد:
    doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table.Rows[1]);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.OneRow.docx");
}

/// <summary>
/// إنشاء مستند مصدر لدمج البريد.
/// </summary>
private static Document CreateSourceDocExecuteDataTable()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.InsertField(" MERGEFIELD CustomerName ");
    builder.InsertParagraph();
    builder.InsertField(" MERGEFIELD Address ");

    return doc;
}

أنظر أيضا