SectionCollection

SectionCollection class

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

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 ، حدد الأمر Insert / Break وحدد نوع الفاصل. يحدد الفاصل ما إذا كان المقطع يبدأ على صفحة جديدة أو على نفس الصفحة.

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

أمثلة

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

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());

أنظر أيضا