SectionCollection

SectionCollection class

Une collection de Section objets dans le document.

public class SectionCollection : NodeCollection

Propriétés

Nom La description
Count { get; } Obtient le nombre de nœuds dans la collection.
Item { get; } Récupère une section à l’index donné. (2 indexers)

Méthodes

Nom La description
Add(Node) Ajoute un nœud à la fin de la collection.
Clear() Supprime tous les nœuds de cette collection et du document.
Contains(Node) Détermine si un nœud est dans la collection.
GetEnumerator() Fournit une simple itération de style “foreach” sur la collection de nœuds.
IndexOf(Node) Renvoie l’index de base zéro du nœud spécifié.
Insert(int, Node) Insère un nœud dans la collection à l’index spécifié.
Remove(Node) Supprime le nœud de la collection et du document.
RemoveAt(int) Supprime le nœud à l’index spécifié de la collection et du document.
ToArray() Copie toutes les sections de la collection dans un nouveau tableau de sections. (2 methods)

Remarques

Un document Microsoft Word peut contenir plusieurs sections. Pour créer une section dans un Microsoft Word, sélectionnez la commande Insert/Break et sélectionnez un type de saut. Le saut spécifie si la section commence sur une nouvelle page ou sur la même page.

L’insertion et la suppression de sections par programmation peuvent être utilisées pour personnaliser les documents produits lors du publipostage. Si un document doit avoir un contenu différent ou des parties du contenu de the en fonction de certains critères, vous pouvez créer un document “maître” qui contient plusieurs sections et supprimer certaines des sections avant ou après le publipostage.

Exemples

Montre comment ajouter et supprimer des sections dans un document.

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

// Supprime la première section du document.
doc.Sections.RemoveAt(0);

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

// Ajoute une copie de ce qui est maintenant la première section à la fin du document.
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());

Voir également