SectionCollection

SectionCollection class

Eine Sammlung vonSection Objekte im Dokument.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Abschnitten Dokumentationsartikel.

public class SectionCollection : NodeCollection

Eigenschaften

NameBeschreibung
Count { get; }Ruft die Anzahl der Knoten in der Sammlung ab.
Item { get; }Ruft einen Abschnitt am angegebenen Index ab. (2 indexers)

Methoden

NameBeschreibung
Add(Node)Fügt am Ende der Sammlung einen Knoten hinzu.
Clear()Entfernt alle Knoten aus dieser Sammlung und aus dem Dokument.
Contains(Node)Bestimmt, ob ein Knoten in der Sammlung vorhanden ist.
GetEnumerator()Bietet eine einfache Iteration im „foreach“-Stil über die Knotensammlung.
IndexOf(Node)Gibt den nullbasierten Index des angegebenen Knotens zurück.
Insert(int, Node)Fügt einen Knoten am angegebenen Index in die Sammlung ein.
Remove(Node)Entfernt den Knoten aus der Sammlung und aus dem Dokument.
RemoveAt(int)Entfernt den Knoten am angegebenen Index aus der Sammlung und aus dem Dokument.
ToArray()Kopiert alle Abschnitte aus der Sammlung in ein neues Abschnittsarray. (2 methods)

Bemerkungen

Ein Microsoft Word-Dokument kann mehrere Abschnitte enthalten. Um einen Abschnitt in Microsoft Word zu erstellen, wählen Sie den Befehl Einfügen/Umbruch und wählen Sie einen Umbruchtyp. Der Umbruch gibt an, ob der Abschnitt auf einer neuen Seite oder auf derselben Seite beginnt.

Das programmatische Einfügen und Entfernen von Abschnitten kann verwendet werden, um während des Seriendrucks erstellte Dokumente anzupassen. Wenn ein Dokument je nach Kriterien unterschiedliche Inhalte oder Teile des Inhalts enthalten muss, können Sie ein Masterdokument mit mehreren Abschnitten erstellen und einige Abschnitte vor oder nach dem Seriendruck löschen.

Beispiele

Zeigt, wie Abschnitte in einem Dokument hinzugefügt und entfernt werden.

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

// Löschen Sie den ersten Abschnitt aus dem Dokument.
doc.Sections.RemoveAt(0);

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

// Fügen Sie eine Kopie des jetzigen ersten Abschnitts an das Ende des Dokuments an.
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());

Siehe auch

Section Class SectionLayoutMode Enum