SectionCollection

SectionCollection class

مجموعة منSection الكائنات الموجودة في المستند.

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

public class SectionCollection : NodeCollection

الخصائص

اسموصف
Count { get; }الحصول على عدد العقد في المجموعة.
Item { get; }استرداد قسم في الفهرس المحدد. (2 indexers)

طُرق

اسموصف
Add(Node)إضافة عقدة إلى نهاية المجموعة.
Clear()إزالة كافة العقد من هذه المجموعة ومن المستند.
Contains(Node)تحديد ما إذا كانت العقدة موجودة في المجموعة.
GetEnumerator()يوفر تكرارًا بسيطًا لنمط “foreach” عبر مجموعة العقد.
IndexOf(Node)إرجاع الفهرس الصفري للعقدة المحددة.
Insert(int, Node)إدراج عقدة في المجموعة في الفهرس المحدد.
Remove(Node)إزالة العقدة من المجموعة ومن المستند.
RemoveAt(int)إزالة العقدة الموجودة في الفهرس المحدد من المجموعة ومن المستند.
ToArray()نسخ كافة الأقسام من المجموعة إلى مجموعة جديدة من الأقسام. (2 methods)

ملاحظات

يمكن أن يحتوي مستند Microsoft Word على أقسام متعددة. لإنشاء قسم في Microsoft Word، حدد أمر إدراج/فاصل وحدد نوع الفاصل. يحدد الفاصل ما إذا كان القسم يبدأ في صفحة جديدة أو في نفس الصفحة.

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

أمثلة

يوضح كيفية إضافة وإزالة الأقسام في المستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Section 1");
builder.InsertBreak(BreakType.SectionBreakNewPage);
builder.Write("Section 2");

Assert.AreEqual("Section 1\x000cSection 2", doc.GetText().Trim());

// احذف القسم الأول من المستند.
doc.Sections.RemoveAt(0);

Assert.AreEqual("Section 2", doc.GetText().Trim());

// إلحاق نسخة مما هو الآن القسم الأول بنهاية المستند.
int lastSectionIdx = doc.Sections.Count - 1;
Section newSection = doc.Sections[lastSectionIdx].Clone();
doc.Sections.Add(newSection);

Assert.AreEqual("Section 2\x000cSection 2", doc.GetText().Trim());

أنظر أيضا