SectionCollection

SectionCollection class

Une collection deSection objets dans le document.

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

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 est dans la collection.
GetEnumerator()Fournit une itération simple 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 Microsoft Word, sélectionnez la commande Insérer/Saut et sélectionnez un type de saut. Le saut indique si la section commence sur une nouvelle page ou sur la même page.

L’insertion et la suppression de sections par programmation permettent de personnaliser les documents produits lors du publipostage. Si un document doit avoir un contenu différent, ou des parties de contenu différentes, selon certains critères, vous pouvez créer un document maître contenant plusieurs sections et en supprimer certaines 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());

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

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

// Ajoutez 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

Section Class SectionLayoutMode Enum