SectionCollection

SectionCollection class

Una raccolta diSection oggetti nel documento.

Per saperne di più, visita ilLavorare con le sezioni articolo di documentazione.

public class SectionCollection : NodeCollection

Proprietà

NomeDescrizione
Count { get; }Ottiene il numero di nodi nella raccolta.
Item { get; }Recupera una sezione all’indice specificato. (2 indexers)

Metodi

NomeDescrizione
Add(Node)Aggiunge un nodo alla fine della raccolta.
Clear()Rimuove tutti i nodi da questa raccolta e dal documento.
Contains(Node)Determina se un nodo è nella raccolta.
GetEnumerator()Fornisce una semplice iterazione in stile “foreach” sulla raccolta di nodi.
IndexOf(Node)Restituisce l’indice basato su zero del nodo specificato.
Insert(int, Node)Inserisce un nodo nella raccolta all’indice specificato.
Remove(Node)Rimuove il nodo dalla raccolta e dal documento.
RemoveAt(int)Rimuove il nodo all’indice specificato dalla raccolta e dal documento.
ToArray()Copia tutte le sezioni dalla raccolta in un nuovo array di sezioni. (2 methods)

Osservazioni

Un documento di Microsoft Word può contenere più sezioni. Per creare una sezione in un documento di Microsoft Word, seleziona il comando Inserisci/Interruzione e seleziona un tipo di interruzione. L’interruzione specifica se la sezione inizia su una nuova pagina o sulla stessa pagina.

L’inserimento e la rimozione di sezioni a livello di codice possono essere utilizzati per personalizzare i documenti prodotti durante la stampa unione. Se un documento deve avere contenuti o parti di contenuto diversi in base a determinati criteri, è possibile creare un documento “master” contenente più sezioni ed eliminarne alcune prima o dopo la stampa unione.

Esempi

Mostra come aggiungere e rimuovere sezioni in un documento.

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

// Elimina la prima sezione dal documento.
doc.Sections.RemoveAt(0);

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

// Aggiungere una copia di quella che ora è la prima sezione alla fine del documento.
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());

Guarda anche

Section Class SectionLayoutMode Enum