Paragraph Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Définit la classe Paragraph.

Cette classe est disponible dans Office 2007 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est w :p.

public class Paragraph : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Paragraph = class
    inherit OpenXmlCompositeElement

Public Class Paragraph
Inherits OpenXmlCompositeElement

Héritage

Object

OpenXmlElement

OpenXmlCompositeElement

Paragraph

Exemples

L’exemple de code suivant ouvre un fichier de traitement de texte existant et y écrit du texte.

using System;  
using DocumentFormat.OpenXml.Packaging;  
using DocumentFormat.OpenXml.Wordprocessing;  

namespace ParagraphEx  
{  
    class Program  
    {  
        // Open an existing file and add text to it.  
        static void Main(string[] args)  
        {  
           string fileName = @"C:\Users\Public\Documents\ParagraphEx.docx";  

           // Open the file for editing.  
           using (WordprocessingDocument wordprocessingDocument =  
               WordprocessingDocument.Open(fileName, true))  
           {  
                    // Get document element of the Package.  
                    Document document =   
                        wordprocessingDocument.MainDocumentPart.Document;  

                    // Add new text to the file.   
                    document.Append(new Body  
                        (new Paragraph  
                            (new Run  
                                (new Text  
                                    ("This is the inserted text by the example.")))));  
                    Console.WriteLine("All done. Press a key.");  
                    Console.ReadKey();  
           }  
        }  
    }  
}  

Imports System  
Imports DocumentFormat.OpenXml.Packaging  
Imports DocumentFormat.OpenXml.Wordprocessing  

Module Module1  

    ' Open an existing file and add text to it.  
    Sub Main()  
        Dim fileName As String = "C:\Users\Public\Documents\ParagraphEx.docx"  

        ' Open the file for editing.  
        Using wordprocessingDocument As WordprocessingDocument = wordprocessingDocument.Open(fileName, True)  
            ' Get document element of the Package.  
            Dim document As Document = wordprocessingDocument.MainDocumentPart.Document  

            ' Add new text to the file.   
            document.Append(New Body _  
                            (New Paragraph _  
                             (New Run _  
                              (New Text _  
                               ("This is the inserted text by the example.")))))  
            Console.WriteLine("All done. Press a key.")  
            Console.ReadKey()  
        End Using  
    End Sub  
End Module  

Remarques

[ISO/IEC 29500-1 1st Edition]

p (Paragraphe)

Cet élément spécifie un paragraphe de contenu dans le document.

Le contenu d’un paragraphe d’un document WordprocessingML doit être constitué d’une combinaison des quatre types de contenu suivants :

• Propriétés de paragraphe

• Annotations (signets, commentaires, révisions)

• Balisage personnalisé

• Contenu au niveau de l’exécution (champs, liens hypertexte, exécutions)

[Exemple : Considérez un document WordprocessingML de base avec un seul paragraphe. Ce paragraphe serait exprimé comme suit :

<w:document>  
  <w:body>  
    <w:p>  
      <w:r>  
        <w:t>Text</w:t>  
      </w:r>  
      <w:fldSimple w:instr="AUTHOR">  
        <w:r>  
          <w:t>Author Name</w:t>  
        </w:r>  
      </w:fldSimple>  
    </w:p>  
  </w:body>  
</w:document>  

L’élément p est le conteneur de tout le contenu du paragraphe, qui, dans cet exemple, inclut à la fois une exécution de texte et un champ simple. Fin de l’exemple]

Éléments parents
corps (§17.2.2) ; commentaire (§17.13.4.2) ; customXml (§17.5.1.6) ; docPartBody (§17.12.6) ; note de fin (§17.11.2) ; note de bas de page (§17.11.10) ; ftr (§17.10.3) ; hdr (§17.10.4) ; sdtContent (§17.5.2.34) ; tc (§17.4.66)

Éléments enfants	Paragraphe
bdo (remplacement bidirectionnel)	§17.3.2.3
bookmarkEnd (Fin du signet)	§17.13.6.1
bookmarkStart (Bookmark Start)	§17.13.6.2
commentRangeEnd (Fin de la plage d’ancres de commentaires)	§17.13.4.3
commentRangeStart (Début de la plage d’ancres de commentaires)	§17.13.4.4
customXml (élément XML personnalisé de niveau inline)	§17.5.1.3
customXmlDelRangeEnd (Fin de suppression de balisage XML personnalisé)	§17.13.5.4
customXmlDelRangeStart (Démarrage de la suppression du balisage XML personnalisé)	§17.13.5.5
customXmlInsRangeEnd (Fin d’insertion de balisage XML personnalisé)	§17.13.5.6
customXmlInsRangeStart (Démarrage de l’insertion de balisage XML personnalisé)	§17.13.5.7
customXmlMoveFromRangeEnd (Fin source du déplacement de balisage XML personnalisé)	§17.13.5.8
customXmlMoveFromRangeStart (Démarrage de la source de déplacement de balisage XML personnalisé)	§17.13.5.9
customXmlMoveToRangeEnd (Fin de l’emplacement de destination du déplacement de balisage XML personnalisé)	§17.13.5.10
customXmlMoveToRangeStart (Emplacement de destination du déplacement du balisage XML personnalisé)	§17.13.5.11
del (Contenu d’exécution supprimé)	§17.13.5.14
dir (niveau d’incorporation bidirectionnel)	§17.3.2.8
fldSimple (champ simple)	§17.16.19
lien hypertexte (lien hypertexte)	§17.16.22
ins (contenu d’exécution inséré)	§17.13.5.18
moveFrom (Déplacer le contenu de l’exécution de la source)	§17.13.5.22
moveFromRangeEnd (Déplacer le conteneur d’emplacement source - Fin)	§17.13.5.23
moveFromRangeStart (Déplacer le conteneur d’emplacement source - Démarrer)	§17.13.5.24
moveTo (Déplacer le contenu de l’exécution de destination)	§17.13.5.25
moveToRangeEnd (Déplacer le conteneur d’emplacement de destination - Fin)	§17.13.5.27
moveToRangeStart (Déplacer le conteneur d’emplacement de destination - Démarrer)	§17.13.5.28
oMath (Office Math)	§22.1.2.77
oMathPara (Paragraphe mathématique Office)	§22.1.2.78
permEnd (Fin de l’autorisation de plage)	§17.13.7.1
permStart (Début de l’autorisation de plage)	§17.13.7.2
pPr (Propriétés de paragraphe)	§17.3.1.26
proofErr (Proofing Error Anchor)	§17.13.8.1
r (Exécution du texte)	§17.3.2.25
sdt (balise de document structuré de niveau inline)	§17.5.2.31
smartTag (balise active de niveau inline)	§17.5.1.9
subDoc (Anchor for Subdocument Location)	§17.17.1.1

Attributs	Description
rsidDel (Identificateur de révision pour la suppression de paragraphe)	Spécifie un identificateur unique utilisé pour suivre la session d’édition lorsque le paragraphe a été supprimé du document main. Tous les attributs rsid* de ce document avec la même valeur, le cas échéant, doivent indiquer que ces régions ont été modifiées au cours de la même session d’édition (délai entre les actions d’enregistrement suivantes). Un producteur peut choisir d’incrémenter la valeur de l’ID d’enregistrement de révision pour indiquer les sessions d’édition suivantes afin d’indiquer l’ordre des modifications par rapport aux autres modifications dans ce document. Les valeurs possibles pour cet attribut sont définies par le type simple ST_LongHexNumber (§17.18.50).
rsidP (Identificateur de révision pour les propriétés de paragraphe)	Cet attribut spécifie un identificateur unique utilisé pour suivre la session d’édition lorsque les propriétés du paragraphe ont été modifiées pour la dernière fois dans ce document. Tous les attributs rsid* de ce document avec la même valeur, le cas échéant, doivent indiquer que ces régions ont été modifiées au cours de la même session d’édition (délai entre les actions d’enregistrement suivantes). Un producteur peut choisir d’incrémenter la valeur de l’ID d’enregistrement de révision pour indiquer les sessions d’édition suivantes afin d’indiquer l’ordre des modifications par rapport aux autres modifications dans ce document. Les valeurs possibles pour cet attribut sont définies par le type simple ST_LongHexNumber (§17.18.50).
rsidR (Identificateur de révision pour le paragraphe)	Cet attribut spécifie un identificateur unique utilisé pour suivre la session d’édition lorsque le paragraphe a été ajouté au document main. Tous les attributs rsid* de ce document avec la même valeur, le cas échéant, doivent indiquer que ces régions ont été modifiées au cours de la même session d’édition (délai entre les actions d’enregistrement suivantes). Un producteur peut choisir d’incrémenter la valeur de l’ID d’enregistrement de révision pour indiquer les sessions d’édition suivantes afin d’indiquer l’ordre des modifications par rapport aux autres modifications dans ce document. Les valeurs possibles pour cet attribut sont définies par le type simple ST_LongHexNumber (§17.18.50).
rsidRDefault (identificateur de révision par défaut pour les exécutions)	Cet attribut spécifie un identificateur unique utilisé pour toutes les exécutions de ce paragraphe qui ne déclarent pas explicitement d’attribut rsidR. Cet attribut permet aux consommateurs d’optimiser les emplacements où les valeurs rsid* sont écrites dans ce document. Tous les attributs rsid* de ce document avec la même valeur, le cas échéant, doivent indiquer que ces régions ont été modifiées au cours de la même session d’édition (délai entre les actions d’enregistrement suivantes). Un producteur peut choisir d’incrémenter la valeur de l’ID d’enregistrement de révision pour indiquer les sessions d’édition suivantes afin d’indiquer l’ordre des modifications par rapport aux autres modifications dans ce document. Les valeurs possibles pour cet attribut sont définies par le type simple ST_LongHexNumber (§17.18.50).
rsidRPr (Identificateur de révision pour la mise en forme du glyphe de paragraphe)	Cet attribut spécifie un identificateur unique utilisé pour suivre la session d’édition lorsque le glyphe représentant la marque de paragraphe a été modifié pour la dernière fois dans le document main. Tous les attributs rsid* de ce document avec la même valeur, le cas échéant, doivent indiquer que ces régions ont été modifiées au cours de la même session d’édition (délai entre les actions d’enregistrement suivantes). Un producteur peut choisir d’incrémenter la valeur de l’ID d’enregistrement de révision pour indiquer les sessions d’édition suivantes afin d’indiquer l’ordre des modifications par rapport aux autres modifications dans ce document. Les valeurs possibles pour cet attribut sont définies par le type simple ST_LongHexNumber (§17.18.50).

[Remarque : La définition de schéma XML W3C du modèle de contenu de cet élément (CT_P) se trouve dans §A.1. Fin de la remarque]

ISO/IEC29500 : 2008.

Constructeurs

Paragraph()	Initialise une nouvelle instance de la classe Paragraph.
Paragraph(IEnumerable<OpenXmlElement>)	Initialise une nouvelle instance de la classe Paragraph avec les éléments enfants spécifiés.
Paragraph(OpenXmlElement[])	Initialise une nouvelle instance de la classe Paragraph avec les éléments enfants spécifiés.
Paragraph(String)	Initialise une nouvelle instance de la classe Paragraph à partir du code XML externe.

Propriétés

ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
ExtendedAttributes	Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement)
Features	Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant. (Hérité de OpenXmlElement)
FirstChild	Obtient le premier enfant de l’élément OpenXmlElement actuel. (Hérité de OpenXmlCompositeElement)
HasAttributes	Obtient une valeur indiquant si l’élément actuel a des attributs. (Hérité de OpenXmlElement)
HasChildren	Obtient une valeur qui indique si l’élément actuel a des éléments enfants. (Hérité de OpenXmlCompositeElement)
InnerText	Obtient ou définit les valeurs concaténées du nœud actuel et de tous ses enfants. (Hérité de OpenXmlCompositeElement)
InnerXml	Obtient ou définit le balisage qui représente uniquement les nœuds enfants du nœud actuel. (Hérité de OpenXmlCompositeElement)
LastChild	Obtient le dernier enfant de l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlCompositeElement)
LocalName	Obtient le nom local de l’élément actuel. (Hérité de OpenXmlElement)
MCAttributes	Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel. (Hérité de OpenXmlElement)
NamespaceDeclarations	Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms. (Hérité de OpenXmlElement)
NamespaceUri	Obtient l’URI d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
NoSpellError	noSpellErr, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : w14 :noSpellErr
OpenXmlElementContext	Obtient l’élément OpenXmlElementContext de l’élément actuel. (Hérité de OpenXmlElement)
OuterXml	Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants. (Hérité de OpenXmlElement)
ParagraphId	paraId, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : w14 :paraId
ParagraphProperties	Propriétés du paragraphe. Représente la balise d’élément suivante dans le schéma : w :pPr.
Parent	Obtient l’élément parent de l’élément actuel. (Hérité de OpenXmlElement)
Prefix	Obtient le préfixe d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
RsidParagraphAddition	Identificateur de révision pour le paragraphe Représente l’attribut suivant dans le schéma : w :rsidR
RsidParagraphDeletion	Identificateur de révision pour la suppression de paragraphes Représente l’attribut suivant dans le schéma : w :rsidDel
RsidParagraphMarkRevision	Identificateur de révision pour la mise en forme du glyphe de paragraphe Représente l’attribut suivant dans le schéma : w :rsidRPr
RsidParagraphProperties	Identificateur de révision pour les propriétés de paragraphe Représente l’attribut suivant dans le schéma : w :rsidP
RsidRunAdditionDefault	Identificateur de révision par défaut pour les exécutions Représente l’attribut suivant dans le schéma : w :rsidRDefault
TextId	textId, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : w14 :textId
XmlQualifiedName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)
XName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)

Méthodes

AddAnnotation(Object)	Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Ajoute l’élément spécifié à l’élément s’il s’agit d’un enfant connu. Cela ajoute l’élément à l’emplacement approprié en fonction du schéma. (Hérité de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Ajoute une déclaration d’espace de noms au nœud actuel. (Hérité de OpenXmlElement)
Ancestors()	Énumère tous les ancêtres de l’élément actuel. (Hérité de OpenXmlElement)
Ancestors<T>()	Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
Annotation(Type)	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotation<T>()	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations(Type)	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations<T>()	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
Append(OpenXmlElement[])	Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
AppendChild<T>(T)	Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
ClearAllAttributes()	Efface tous les attributs, y compris les attributs connus et les attributs étendus. (Hérité de OpenXmlElement)
Clone()	Crée un doublon du nœud actuel. (Hérité de OpenXmlElement)
CloneNode(Boolean)	Crée un doublon de ce nœud.
Descendants()	Énumère tous les descendants de l’élément actuel. (Hérité de OpenXmlElement)
Descendants<T>()	Énumérez tous les descendants de l’élément actuel de type T. (Hérité de OpenXmlElement)
Elements()	Énumère tous les enfants de l’élément actuel. (Hérité de OpenXmlElement)
Elements<T>()	Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
ElementsAfter()	Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
ElementsBefore()	Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
GetAttribute(String, String)	Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés. (Hérité de OpenXmlElement)
GetAttributes()	Obtient une liste qui contient une copie de tous les attributs. (Hérité de OpenXmlElement)
GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)
GetFirstChild<T>()	Recherche le premier élément enfant de type T. (Hérité de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insère l’élément spécifié immédiatement après l’élément de référence spécifié. (Hérité de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Insère l’élément spécifié immédiatement après l’élément actuel. (Hérité de OpenXmlElement)
InsertAt<T>(T, Int32)	Insère l’élément spécifié à l’index spécifié des enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insère l’élément spécifié juste avant l’élément de référence spécifié. (Hérité de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insère l’élément spécifié juste avant l’élément actuel. (Hérité de OpenXmlElement)
IsAfter(OpenXmlElement)	Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
IsBefore(OpenXmlElement)	Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
LookupNamespace(String)	Résout le préfixe d’espace de noms dans le contexte du nœud actuel. (Hérité de OpenXmlElement)
LookupPrefix(String)	Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel. (Hérité de OpenXmlElement)
NextSibling()	Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
NextSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
PrependChild<T>(T)	Insère l’élément spécifié au début de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
PreviousSibling()	Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
PreviousSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
Remove()	Supprime l’élément actuel de son parent. (Hérité de OpenXmlElement)
RemoveAllChildren()	Supprime tous les éléments enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Supprimez tous les éléments enfants de l’élément actuel qui sont de type T. (Hérité de OpenXmlElement)
RemoveAnnotations(Type)	Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAnnotations<T>()	Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAttribute(String, String)	Supprime l’attribut de l’élément actuel. (Hérité de OpenXmlElement)
RemoveChild<T>(T)	Supprime l’élément enfant spécifié. (Hérité de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe. (Hérité de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Remplace l’un des éléments enfants de l’élément actuel par un autre élément OpenXmlElement. (Hérité de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
WriteTo(XmlWriter)	Enregistre le nœud actuel dans le XmlWriter spécifié. (Hérité de OpenXmlElement)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()	Définit la classe Paragraph. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est w :p. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)