Section

Section class

Representerar en enskild sektion i ett dokument.

För att lära dig mer, besökArbeta med sektioner dokumentationsartikel.

public sealed class Section : CompositeNode

Konstruktörer

namnBeskrivning
Section(DocumentBase)Initierar en ny instans av klassen Sektion.

Egenskaper

namnBeskrivning
Body { get; }ReturnerarBody barnnod för sektionen.
Count { get; }Hämtar antalet omedelbara barn till denna nod.
CustomNodeId { get; set; }Anger anpassad nodidentifierare.
virtual Document { get; }Hämtar dokumentet som denna nod tillhör.
FirstChild { get; }Får det första barnet i noden.
HasChildNodes { get; }ReturnerarSann om denna nod har några undernoder.
HeadersFooters { get; }Ger åtkomst till noder för sidhuvuden och sidfötter i avsnittet.
override IsComposite { get; }ReturnerarSann eftersom denna nod kan ha underordnade noder.
LastChild { get; }Hämtar nodens sista underordnade.
NextSibling { get; }Hämtar noden omedelbart efter denna nod.
override NodeType { get; }ReturnerarSection .
PageSetup { get; }Returnerar ett objekt som representerar sidinställningar och avsnittsegenskaper.
ParentNode { get; }Hämtar den omedelbara föräldern till denna nod.
PreviousSibling { get; }Hämtar noden omedelbart före denna nod.
ProtectedForForms { get; set; }Sant om avsnittet är skyddat för formulär. När en sektion är skyddad för formulär kan användare välja och ändra text endast i formulärfält i Microsoft Word.
Range { get; }Returnerar enRange objekt som representerar den del av ett dokument som finns i denna nod.

Metoder

namnBeskrivning
override Accept(DocumentVisitor)Accepterar en besökare.
AppendChild(Node)Lägger till den angivna noden i slutet av listan över underordnade noder för denna nod.
AppendContent(Section)Infogar en kopia av innehållet i källavsnittet i slutet av det här avsnittet.
ClearContent()Rensar avsnittet.
ClearHeadersFooters()Rensar sidhuvuden och sidfötter i det här avsnittet.
Clone()Skapar en dubblett av detta avsnitt.
Clone(bool)Skapar en dubblett av noden.
CreateNavigator()Skapar navigator som kan användas för att korsa och läsa noder.
DeleteHeaderFooterShapes()Tar bort alla former (ritobjekt) från sidhuvuden och sidfötter i det här avsnittet.
EnsureMinimum()Säkerställer att avsnittet harBody med enParagraph .
GetAncestor(NodeType)Hämtar den första förfadern till den angivnaNodeType .
GetAncestor(Type)Hämtar den första förfadern till den angivna objekttypen.
GetChild(NodeType, int, bool)Returnerar en N:te underordnad nod som matchar den angivna typen.
GetChildNodes(NodeType, bool)Returnerar en aktiv samling av underordnade noder som matchar den angivna typen.
GetEnumerator()Tillhandahåller stöd för varje stiliteration över undernoderna för denna nod.
override GetText()Hämtar texten för denna nod och alla dess underordnade.
IndexOf(Node)Returnerar indexet för den angivna undernoden i den underordnade nodmatrisen.
InsertAfter(NodeNode)Infogar den angivna noden omedelbart efter den angivna referensnoden.
InsertBefore(NodeNode)Infogar den angivna noden omedelbart före den angivna referensnoden.
NextPreOrder(Node)Hämtar nästa nod enligt algoritmen för förbeställningsträdet.
PrependChild(Node)Lägger till den angivna noden i början av listan över underordnade noder för denna nod.
PrependContent(Section)Infogar en kopia av innehållet i källavsnittet i början av det här avsnittet.
PreviousPreOrder(Node)Hämtar föregående nod enligt algoritmen för förbeställningsträdet.
Remove()Tar bort sig själv från föräldern.
RemoveAllChildren()Tar bort alla undernoder för den aktuella noden.
RemoveChild(Node)Tar bort den angivna underordnade noden.
RemoveSmartTags()Tar bort allaSmartTagunderliggande noder till den aktuella noden.
SelectNodes(string)Väljer en lista med noder som matchar XPath-uttrycket.
SelectSingleNode(string)Väljer den förstaNode som matchar XPath-uttrycket.
ToString(SaveFormat)Exporterar innehållet i noden till en sträng i angivet format.
ToString(SaveOptions)Exporterar innehållet i noden till en sträng med de angivna sparalternativen.

Anmärkningar

Section kan ha enBody och max enHeaderFooter av varjeHeaderFooterType .Body ochHeaderFooter nodes kan vara i valfri ordning inutiSection.

Ett minimalt giltigt avsnitt måste haBody med enParagraph.

Varje avsnitt har sin egen uppsättning egenskaper som anger sidstorlek, orientering, marginaler etc.

Du kan skapa en kopia av ett avsnitt medClone. Kopian kan infogas i samma eller ett annat dokument.

För att lägga till, infoga eller ta bort ett helt avsnitt inklusive avsnittsbrytning och avsnittsegenskaper använd metoderna iSections objekt.

För att kopiera och infoga bara innehållet i avsnittet exklusive avsnittet break och avsnittsegenskaper användAppendContent ochPrependContent metoder.

Exempel

Visar hur man konstruerar ett Aspose.Words-dokument för hand.

Document doc = new Document();

// Ett tomt dokument innehåller ett avsnitt, en brödtext och ett stycke.
// Anropa metoden "RemoveAllChildren" för att ta bort alla dessa noder,
// och slutar med en dokumentnod utan underordnade.
doc.RemoveAllChildren();

// Det här dokumentet har nu inga sammansatta underordnade noder som vi kan lägga till innehåll till.
// Om vi vill redigera den måste vi fylla på dess nodsamling.
// Skapa först ett nytt avsnitt och lägg sedan till det som ett underordnat dokument i rotdokumentnoden.
Section section = new Section(doc);
doc.AppendChild(section);

// Ställ in några sidinställningar för avsnittet.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// En sektion behöver en kropp som kommer att innehålla och visa allt dess innehåll
// på sidan mellan avsnittets sidhuvud och sidfot.
Body body = new Body(doc);
section.AppendChild(body);

// Skapa ett stycke, ange några formateringsegenskaper och lägg sedan till det som ett underordnat stycke i brödtexten.
Paragraph para = new Paragraph(doc);

para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;

body.AppendChild(para);

// Slutligen, lägg till lite innehåll för att göra dokumentet. Skapa en löprunda,
// ställ in dess utseende och innehåll och lägg sedan till det som ett barn till stycket.
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");

Se även