Section
Section class
Rappresenta una singola sezione in un documento.
Per saperne di più, visita ilLavorare con le sezioni articolo di documentazione.
public sealed class Section : CompositeNode
Costruttori
Nome | Descrizione |
---|---|
Section(DocumentBase) | Inizializza una nuova istanza della classe Sezione. |
Proprietà
Nome | Descrizione |
---|---|
Body { get; } | Restituisce ilBody nodo figlio della sezione. |
Count { get; } | Ottiene il numero di figli immediati di questo nodo. |
CustomNodeId { get; set; } | Specifica l’identificatore del nodo personalizzato. |
virtual Document { get; } | Ottiene il documento a cui appartiene questo nodo. |
FirstChild { get; } | Ottiene il primo figlio del nodo. |
HasChildNodes { get; } | RestituisceVERO se questo nodo ha nodi figli. |
HeadersFooters { get; } | Fornisce l’accesso ai nodi intestazioni e piè di pagina della sezione. |
override IsComposite { get; } | RestituisceVERO poiché questo nodo può avere nodi figli. |
LastChild { get; } | Ottiene l’ultimo figlio del nodo. |
NextSibling { get; } | Ottiene il nodo immediatamente successivo a questo nodo. |
override NodeType { get; } | RestituisceSection . |
PageSetup { get; } | Restituisce un oggetto che rappresenta l’impostazione della pagina e le proprietà della sezione. |
ParentNode { get; } | Ottiene il genitore immediato di questo nodo. |
PreviousSibling { get; } | Ottiene il nodo immediatamente precedente questo nodo. |
ProtectedForForms { get; set; } | Vero se la sezione è protetta per i moduli. Quando una sezione è protetta per i moduli, gli utenti possono selezionare e modificare il testo solo nei campi modulo in Microsoft Word. |
Range { get; } | Restituisce aRange oggetto che rappresenta la porzione di documento contenuta in questo nodo. |
Metodi
Nome | Descrizione |
---|---|
override Accept(DocumentVisitor) | Accetta un visitatore. |
AppendChild(Node) | Aggiunge il nodo specificato alla fine dell’elenco dei nodi secondari per questo nodo. |
AppendContent(Section) | Inserisce una copia del contenuto della sezione sorgente alla fine di questa sezione. |
ClearContent() | Cancella la sezione. |
ClearHeadersFooters() | Cancella le intestazioni e i piè di pagina di questa sezione. |
Clone() | Crea un duplicato di questa sezione. |
Clone(bool) | Crea un duplicato del nodo. |
CreateNavigator() | Crea un navigatore che può essere utilizzato per attraversare e leggere i nodi. |
DeleteHeaderFooterShapes() | Elimina tutte le forme (oggetti di disegno) dalle intestazioni e dai piè di pagina di questa sezione. |
EnsureMinimum() | Garantisce che la sezione abbiaBody con unoParagraph . |
GetAncestor(NodeType) | Ottiene il primo antenato dell’oggetto specificatoNodeType . |
GetAncestor(Type) | Ottiene il primo antenato del tipo di oggetto specificato. |
GetChild(NodeType, int, bool) | Restituisce un Nesimo nodo figlio che corrisponde al tipo specificato. |
GetChildNodes(NodeType, bool) | Restituisce una raccolta attiva di nodi secondari che corrispondono al tipo specificato. |
GetEnumerator() | Fornisce il supporto per l’iterazione di ogni stile sui nodi figlio di questo nodo. |
override GetText() | Ottiene il testo di questo nodo e di tutti i suoi figli. |
IndexOf(Node) | Restituisce l’indice del nodo figlio specificato nell’array di nodi figlio. |
InsertAfter(Node, Node) | Inserisce il nodo specificato immediatamente dopo il nodo di riferimento specificato. |
InsertBefore(Node, Node) | Inserisce il nodo specificato immediatamente prima del nodo di riferimento specificato. |
NextPreOrder(Node) | Ottiene il nodo successivo in base all’algoritmo di attraversamento dell’albero di preordine. |
PrependChild(Node) | Aggiunge il nodo specificato all’inizio dell’elenco dei nodi secondari per questo nodo. |
PrependContent(Section) | Inserisce una copia del contenuto della sezione sorgente all’inizio di questa sezione. |
PreviousPreOrder(Node) | Ottiene il nodo precedente in base all’algoritmo di attraversamento dell’albero di preordine. |
Remove() | Si rimuove dal genitore. |
RemoveAllChildren() | Rimuove tutti i nodi figlio del nodo corrente. |
RemoveChild(Node) | Rimuove il nodo figlio specificato. |
RemoveSmartTags() | Rimuove tuttoSmartTag nodi discendenti del nodo corrente. |
SelectNodes(string) | Seleziona un elenco di nodi che corrispondono all’espressione XPath. |
SelectSingleNode(string) | Seleziona il primoNode che corrisponde all’espressione XPath. |
ToString(SaveFormat) | Esporta il contenuto del nodo in una stringa nel formato specificato. |
ToString(SaveOptions) | Esporta il contenuto del nodo in una stringa utilizzando le opzioni di salvataggio specificate. |
Osservazioni
Section
può averne unoBody
e massimo unoHeaderFooter
di ciascunoHeaderFooterType
.Body
EHeaderFooter
nodes può essere in qualsiasi ordine all’internoSection
.
È necessario avere una sezione minima validaBody
con unoParagraph
.
Ogni sezione ha il proprio set di proprietà che specificano la dimensione della pagina, l’orientamento, i margini, ecc.
Puoi creare una copia di una sezione utilizzandoClone
. La copia può essere inserita nello stesso documento o in un documento diverso.
Per aggiungere, inserire o rimuovere un’intera sezione, comprese le proprietà di interruzione di sezione e di sezione , utilizzare i metodi diSections
oggetto.
Per copiare e inserire solo il contenuto della sezione escludendo la sezione break e le proprietà della sezione utilizzareAppendContent
EPrependContent
metodi.
Esempi
Mostra come costruire manualmente un documento Aspose.Words.
Document doc = new Document();
// Un documento vuoto contiene una sezione, un corpo e un paragrafo.
// Chiama il metodo "RemoveAllChildren" per rimuovere tutti questi nodi,
// e finiamo con un nodo documento senza figli.
doc.RemoveAllChildren();
// Questo documento ora non ha nodi secondari compositi a cui possiamo aggiungere contenuto.
// Se desideriamo modificarlo, dovremo ripopolare la sua raccolta di nodi.
// Innanzitutto, crea una nuova sezione, quindi aggiungila come figlia al nodo del documento root.
Section section = new Section(doc);
doc.AppendChild(section);
// Imposta alcune proprietà di impostazione della pagina per la sezione.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;
// Una sezione necessita di un corpo, che conterrà e visualizzerà tutto il suo contenuto
// nella pagina tra l'intestazione e il piè di pagina della sezione.
Body body = new Body(doc);
section.AppendChild(body);
// Crea un paragrafo, imposta alcune proprietà di formattazione e quindi lo aggiunge come figlio al corpo.
Paragraph para = new Paragraph(doc);
para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;
body.AppendChild(para);
// Infine, aggiungi del contenuto per realizzare il documento. Crea una corsa,
// ne imposta l'aspetto e il contenuto, quindi lo aggiunge come figlio al paragrafo.
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);
Assert.AreEqual("Hello World!", doc.GetText().Trim());
doc.Save(ArtifactsDir + "Section.CreateManually.docx");
Guarda anche
- class CompositeNode
- spazio dei nomi Aspose.Words
- assemblea Aspose.Words