SectionCollection

SectionCollection class

Una raccolta di Sezione oggetti nel documento.

public class SectionCollection : NodeCollection

Proprietà

Nome Descrizione
Count { get; } Ottiene il numero di nodi nella raccolta.
Item { get; } Recupera una sezione in corrispondenza dell’indice specificato. (2 indexers)

Metodi

Nome Descrizione
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 di stile “foreach” sulla raccolta di nodi.
IndexOf(Node) Restituisce l’indice in base zero del nodo specificato.
Insert(int, Node) Inserisce un nodo nella raccolta in corrispondenza dell’indice specificato.
Remove(Node) Rimuove il nodo dalla raccolta e dal documento.
RemoveAt(int) Rimuove il nodo in corrispondenza dell’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 Microsoft Word, seleziona il comando Inserisci/Interrompi 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 contenuto o parti di differenti a seconda di alcuni criteri, puoi creare un documento “master” che contenga più sezioni ed eliminare alcune delle sezioni 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());

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