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 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 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 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 può essere utilizzato per personalizzare i documenti prodotti durante la stampa unione. Se un documento deve avere contenuti diversi o parti del contenuto in base ad alcuni criteri, puoi creare un documento “principale” che contenga più sezioni ed eliminare alcune 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());

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