SectionCollection

SectionCollection class

Une collection deSection objets dans le document.

Pour en savoir plus, visitez leTravailler avec des sections article documentaire.

public class SectionCollection : NodeCollection

Propriétés

NomLa 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

NomLa 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 fait partie de 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 vers un nouveau tableau de sections. (2 methods)

Remarques

Un document Microsoft Word peut contenir plusieurs sections. Pour créer une section dans Microsoft Word, sélectionnez la commande Insérer/Sauter et sélectionnez un type de saut. Le saut précise si la section démarre sur une nouvelle page ou sur la même page.

L’insertion et la suppression de sections par programme 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 en fonction de certains critères, vous pouvez alors 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