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) |
ملاحظات
يمكن أن يحتوي مستند مايكروسوفت وورد على عدة أقسام. لإنشاء قسم في مايكروسوفت وورد، حدد أمر “إدراج/فصل” وحدد نوع الفصل. يحدد الفصل ما إذا كان القسم سيبدأ في صفحة جديدة أم في الصفحة نفسها.
يمكن استخدام إدراج الأقسام وإزالتها برمجيًا لتخصيص المستندات المُنتَجة أثناء دمج البريد. إذا احتاج مستند إلى محتوى مختلف أو أجزاء مختلفة من محتوى x000d_ بناءً على بعض المعايير، فيمكنك إنشاء مستند “رئيسي” يحتوي على أقسام متعددة وحذف بعض الأقسام قبل دمج البريد أو بعده.
أمثلة
يوضح كيفية إضافة أقسام وإزالتها في مستند.
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());
أنظر أيضا
- class NodeCollection
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words