Section

Section class

Représente une seule section dans un document.

Pour en savoir plus, visitez leTravailler avec des sections article documentaire.

public sealed class Section : CompositeNode

Constructeurs

Nom	La description
Section(DocumentBase)	Initialise une nouvelle instance de la classe Section.

Propriétés

Nom	La description
Body { get; }	Renvoie leBody nœud enfant de la section.
Count { get; }	Obtient le nombre d’enfants immédiats de ce nœud.
CustomNodeId { get; set; }	Spécifie l’identifiant de nœud personnalisé.
virtual Document { get; }	Obtient le document auquel appartient ce nœud.
FirstChild { get; }	Obtient le premier enfant du nœud.
HasChildNodes { get; }	Retoursvrai si ce nœud a des nœuds enfants.
HeadersFooters { get; }	Donne accès aux nœuds d’en-têtes et de pieds de page de la section.
override IsComposite { get; }	Retoursvrai car ce nœud peut avoir des nœuds enfants.
LastChild { get; }	Obtient le dernier enfant du nœud.
NextSibling { get; }	Obtient le nœud suivant immédiatement ce nœud.
override NodeType { get; }	RetoursSection .
PageSetup { get; }	Renvoie un objet qui représente la mise en page et les propriétés de section.
ParentNode { get; }	Obtient le parent immédiat de ce nœud.
PreviousSibling { get; }	Obtient le nœud précédant immédiatement ce nœud.
ProtectedForForms { get; set; }	True si la section est protégée pour les formulaires. Lorsqu’une section est protégée pour les formulaires, les utilisateurs peuvent sélectionner et modifier le texte uniquement dans les champs de formulaire de Microsoft Word.
Range { get; }	Renvoie unRange objet qui représente la partie d’un document contenue dans ce nœud.

Méthodes

Nom	La description
override Accept(DocumentVisitor)	Accepte un visiteur.
AppendChild(Node)	Ajoute le nœud spécifié à la fin de la liste des nœuds enfants pour ce nœud.
AppendContent(Section)	Insère une copie du contenu de la section source à la fin de cette section.
ClearContent()	Efface la section.
ClearHeadersFooters()	Efface les en-têtes et pieds de page de cette section.
Clone()	Crée un double de cette section.
Clone(bool)	Crée un duplicata du nœud.
CreateNavigator()	Crée un navigateur qui peut être utilisé pour parcourir et lire des nœuds.
DeleteHeaderFooterShapes()	Supprime toutes les formes (objets de dessin) des en-têtes et pieds de page de cette section.
EnsureMinimum()	Garantit que la section aBody avec unParagraph .
GetAncestor(NodeType)	Obtient le premier ancêtre du spécifiéNodeType .
GetAncestor(Type)	Obtient le premier ancêtre du type d’objet spécifié.
GetChild(NodeType, int, bool)	Renvoie un Nième nœud enfant qui correspond au type spécifié.
GetChildNodes(NodeType, bool)	Renvoie une collection active de nœuds enfants qui correspondent au type spécifié.
GetEnumerator()	Fournit la prise en charge de chaque itération de style sur les nœuds enfants de ce nœud.
override GetText()	Récupère le texte de ce nœud et de tous ses enfants.
IndexOf(Node)	Renvoie l’index du nœud enfant spécifié dans le tableau de nœuds enfants.
InsertAfter(Node, Node)	Insère le nœud spécifié immédiatement après le nœud de référence spécifié.
InsertBefore(Node, Node)	Insère le nœud spécifié immédiatement avant le nœud de référence spécifié.
NextPreOrder(Node)	Obtient le nœud suivant selon l’algorithme de traversée de l’arbre de pré-commande.
PrependChild(Node)	Ajoute le nœud spécifié au début de la liste des nœuds enfants pour ce nœud.
PrependContent(Section)	Insère une copie du contenu de la section source au début de cette section.
PreviousPreOrder(Node)	Obtient le nœud précédent selon l’algorithme de traversée d’arbre de pré-commande.
Remove()	Se supprime du parent.
RemoveAllChildren()	Supprime tous les nœuds enfants du nœud actuel.
RemoveChild(Node)	Supprime le nœud enfant spécifié.
RemoveSmartTags()	Supprime toutSmartTagnœuds descendants du nœud actuel.
SelectNodes(string)	Sélectionne une liste de nœuds correspondant à l’expression XPath.
SelectSingleNode(string)	Sélectionne le premierNode qui correspond à l’expression XPath.
ToString(SaveFormat)	Exporte le contenu du nœud dans une chaîne au format spécifié.
ToString(SaveOptions)	Exporte le contenu du nœud dans une chaîne à l’aide des options de sauvegarde spécifiées.

Remarques

Section je peux en avoir unBody et maximum unHeaderFooter de chacunHeaderFooterType .Body etHeaderFooter nodes peut être dans n’importe quel ordre à l’intérieurSection.

Une section minimale valide doit avoirBody avec unParagraph.

Chaque section possède son propre ensemble de propriétés qui spécifient la taille de la page, l’orientation, les marges, etc.

Vous pouvez créer une copie d’une section en utilisantClone. La copie peut être insérée dans le même document ou un document différent.

Pour ajouter, insérer ou supprimer une section entière, y compris les sauts de section et les propriétés de section , utilisez les méthodes deSections objet.

Pour copier et insérer uniquement le contenu de la section à l’exclusion de la section break et des propriétés de la section, utilisezAppendContent etPrependContent méthodes.

Exemples

Montre comment construire manuellement un document Aspose.Words.

Document doc = new Document();

// Un document vierge contient une section, un corps et un paragraphe.
// Appelez la méthode "RemoveAllChildren" pour supprimer tous ces nœuds,
// et on se retrouve avec un nœud de document sans enfants.
doc.RemoveAllChildren();

// Ce document n'a désormais aucun nœud enfant composite auquel nous pouvons ajouter du contenu.
// Si nous souhaitons le modifier, nous devrons repeupler sa collection de nœuds.
// Commencez par créer une nouvelle section, puis ajoutez-la en tant qu'enfant au nœud du document racine.
Section section = new Section(doc);
doc.AppendChild(section);

// Définissez certaines propriétés de mise en page pour la section.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// Une section a besoin d'un corps, qui contiendra et affichera tout son contenu
// sur la page entre l'en-tête et le pied de page de la section.
Body body = new Body(doc);
section.AppendChild(body);

// Créez un paragraphe, définissez certaines propriétés de mise en forme, puis ajoutez-le en tant qu'enfant au corps.
Paragraph para = new Paragraph(doc);

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

body.AppendChild(para);

// Enfin, ajoutez du contenu pour faire le document. Créez une course,
// définit son apparence et son contenu, puis l'ajoute en tant qu'enfant au paragraphe.
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");

Voir également

• class CompositeNode
• espace de noms Aspose.Words
• Assemblée Aspose.Words