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 einen Knoten am Ende der Sammlung hinzu.
Clear()Entfernt alle Knoten aus dieser Sammlung und aus dem Dokument.
Contains(Node)Bestimmt, ob ein Knoten in der Sammlung ist.
GetEnumerator()Bietet eine einfache Iteration im „foreach“-Stil über die Sammlung von Knoten.
IndexOf(Node)Gibt den nullbasierten Index des angegebenen Knotens zurück.
Insert(int, Node)Fügt am angegebenen Index einen Knoten 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 Array von Abschnitten. (2 methods)

Bemerkungen

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

Das programmgesteuerte Einfügen und Entfernen von Abschnitten kann verwendet werden, um während des Seriendrucks erstellte Dokumente anzupassen . Wenn ein Dokument abhängig von bestimmten Kriterien unterschiedliche Inhalte oder Teile davon haben muss, können Sie ein „Master“-Dokument erstellen, das mehrere Abschnitte enthält, und einige der 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());

// Den ersten Abschnitt aus dem Dokument löschen.
doc.Sections.RemoveAt(0);

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

// Eine Kopie des nun ersten Abschnitts an das Ende des Dokuments anhängen.
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