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; }الحصول على شكل خلفية المستند أو تعيينه. يمكن ان يكونباطل .
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; }يوفر خيارات تتحكم في ترقيم الحواشي السفلية وموضعها في هذا المستند.
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; }للحصول على نوع حماية المستند النشط حاليًا.
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; }الحصول على أو تعيين aVbaProject .
VersionsCount { get; }الحصول على عدد إصدارات المستند التي تم تخزينها في مستند DOC.
ViewOptions { get; }يوفر خيارات للتحكم في كيفية عرض المستند في Microsoft Word.
WarningCallback { get; set; }يتم استدعاؤه أثناء إجراءات معالجة المستندات المختلفة عند اكتشاف مشكلة قد تؤدي إلى فقدان دقة البيانات أو التنسيق.
Watermark { get; }يوفر الوصول إلى العلامة المائية للمستند.
WebExtensionTaskPanes { get; }إرجاع مجموعة تمثل قائمة بالوظائف الإضافية لجزء المهام.
WriteProtection { get; }يوفر الوصول إلى خيارات الحماية ضد الكتابة في المستند.

طُرق

اسموصف
override Accept(DocumentVisitor)يقبل الزائر.
AcceptAllRevisions()قبول كافة التغييرات المتعقبة في المستند.
AppendChild(Node)إضافة العقدة المحددة إلى نهاية قائمة العقد التابعة لهذه العقدة.
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(NodeNode)يقوم بإدراج العقدة المحددة مباشرة بعد العقدة المرجعية المحددة.
InsertBefore(NodeNode)يقوم بإدراج العقدة المحددة مباشرة قبل العقدة المرجعية المحددة.
JoinRunsWithSameFormatting()يتم تشغيل عمليات الانضمام بنفس التنسيق في جميع فقرات المستند.
NextPreOrder(Node)الحصول على العقدة التالية وفقًا لخوارزمية اجتياز شجرة الطلب المسبق.
NormalizeFieldTypes()تغيير قيم نوع الحقلFieldType لFieldStart ,FieldSeparator ,FieldEnd في المستند بأكمله بحيث تتوافق مع أنواع الحقول الموجودة في رموز الحقول.
PrependChild(Node)إضافة العقدة المحددة إلى بداية قائمة العقد التابعة لهذه العقدة.
PreviousPreOrder(Node)الحصول على العقدة السابقة وفقًا لخوارزمية اجتياز شجرة الطلب المسبق.
Print()طباعة المستند بالكامل إلى الطابعة الافتراضية.
Print(PrinterSettings)يطبع المستند وفقًا لإعدادات الطابعة المحددة، باستخدام وحدة التحكم في الطباعة القياسية (بدون واجهة مستخدم).
Print(string)طباعة المستند بالكامل إلى الطابعة المحددة، باستخدام وحدة التحكم في الطباعة القياسية (بدون واجهة مستخدم).
Print(PrinterSettings, string)يطبع المستند وفقًا لإعدادات الطابعة المحددة، باستخدام وحدة التحكم في الطباعة القياسية (بدون واجهة مستخدم) واسم المستند.
Protect(ProtectionType)يحمي المستند من التغييرات دون تغيير كلمة المرور الحالية أو تعيين كلمة مرور عشوائية.
Protect(ProtectionType, string)يحمي المستند من التغييرات ويعين كلمة مرور الحماية بشكل اختياري.
Remove()يزيل نفسه من الأصل.
RemoveAllChildren()إزالة جميع العقد الفرعية للعقدة الحالية.
RemoveChild(Node)إزالة العقدة الفرعية المحددة.
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)إزالة الحماية عن المستند إذا تم تحديد كلمة مرور صحيحة.
UpdateFields()يقوم بتحديث قيم الحقول في المستند بأكمله.
UpdateListLabels()تحديث تسميات القائمة لجميع عناصر القائمة في المستند.
UpdatePageLayout()يعيد بناء تخطيط الصفحة للمستند.
UpdateThumbnail()التحديثاتThumbnail للمستند باستخدام الخيارات الافتراضية.
UpdateThumbnail(ThumbnailGeneratingOptions)التحديثاتThumbnail للمستند حسب الخيارات المحددة.
UpdateWordCount()لتحديث خصائص عدد الكلمات في المستند.
UpdateWordCount(bool)يقوم بتحديث خصائص عدد الكلمات في المستند، ويتم تحديثه بشكل اختياريLines الملكية.

ملاحظات

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

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

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

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

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

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

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

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

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

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

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

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

أمثلة

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

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" });

    // فيما يلي طريقتان لاستخدام DataTable كمصدر بيانات لدمج البريد.
    // 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;
}

أنظر أيضا