Paragraph Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Wordprocessing

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v3.0.1

Define la clase Paragraph.

Esta clase está disponible en Office 2007 y versiones posteriores.

Cuando el objeto se serializa como xml, su nombre completo es w:p.

public class Paragraph : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Paragraph = class
    inherit OpenXmlCompositeElement

Public Class Paragraph
Inherits OpenXmlCompositeElement

Herencia

Object

OpenXmlElement

OpenXmlCompositeElement

Paragraph

Ejemplos

En el ejemplo de código siguiente se abre un archivo de procesamiento de texto existente y se escribe texto en él.

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  

Comentarios

[ISO/IEC 29500-1 1.ª edición]

p (párrafo)

Este elemento especifica un párrafo de contenido en el documento.

El contenido de un párrafo de un documento WordprocessingML constará de cualquier combinación de los cuatro tipos de contenido siguientes:

• Propiedades de párrafo

• Anotaciones (marcadores, comentarios, revisiones)

• Marcado personalizado

• Contenido de nivel de ejecución (campos, hipervínculos, ejecuciones)

[Ejemplo: considere la posibilidad de un documento WordprocessingML básico con un solo párrafo. Este párrafo se expresaría de la siguiente manera:

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

El elemento p es el contenedor de todo el contenido del párrafo, que en este ejemplo incluye una ejecución de texto y un campo simple. Fin del ejemplo]

Elementos primarios
body (§17.2.2); comment (§17.13.4.2); customXml (§17.5.1.6); docPartBody (§17.12.6); nota al final (§17.11.2); footnote (§17.11.10); ftr (§17.10.3); hdr (§17.10.4); sdtContent (§17.5.2.34); tc (§17.4.66)

Elementos secundarios	Subclause
bdo (Invalidación bidireccional)	§17.3.2.3
bookmarkEnd (marcador final)	§17.13.6.1
bookmarkStart (Inicio de marcador)	§17.13.6.2
commentRangeEnd (final del intervalo de delimitador de comentario)	§17.13.4.3
commentRangeStart (Inicio del intervalo de delimitador de comentario)	§17.13.4.4
customXml (elemento XML personalizado en línea)	§17.5.1.3
customXmlDelRangeEnd (finalización de eliminación de marcado XML personalizado)	§17.13.5.4
customXmlDelRangeStart (Inicio de eliminación de marcado XML personalizado)	§17.13.5.5
customXmlInsRangeEnd (extremo de inserción de marcado XML personalizado)	§17.13.5.6
customXmlInsRangeStart (inicio de inserción de marcado XML personalizado)	§17.13.5.7
customXmlMoveFromRangeEnd (custom XML Markup Move Source End)	§17.13.5.8
customXmlMoveFromRangeStart (Inicio de origen de movimiento de marcado XML personalizado)	§17.13.5.9
customXmlMoveToRangeEnd (extremo de ubicación de destino de movimiento de marcado XML personalizado)	§17.13.5.10
customXmlMoveToRangeStart (Inicio de ubicación de destino de movimiento de marcado XML personalizado)	§17.13.5.11
del (Contenido de ejecución eliminado)	§17.13.5.14
dir (nivel de inserción bidireccional)	§17.3.2.8
fldSimple (campo simple)	§17.16.19
hyperlink (Hyperlink)	§17.16.22
ins (contenido de ejecución insertado)	§17.13.5.18
moveFrom (Mover contenido de ejecución de origen)	§17.13.5.22
moveFromRangeEnd (Move Source Location Container - End)	§17.13.5.23
moveFromRangeStart (Mover contenedor de ubicación de origen - Inicio)	§17.13.5.24
moveTo (Mover contenido de ejecución de destino)	§17.13.5.25
moveToRangeEnd (Mover contenedor de ubicación de destino - Fin)	§17.13.5.27
moveToRangeStart (Move Destination Location Container - Start)	§17.13.5.28
oMath (Matemáticas de Office)	§22.1.2.77
oMathPara (párrafo matemático de Office)	§22.1.2.78
permEnd (fin del permiso de intervalo)	§17.13.7.1
permStart (inicio del permiso de intervalo)	§17.13.7.2
pPr (propiedades de párrafo)	§17.3.1.26
proofErr (delimitador de errores de corrección)	§17.13.8.1
r (ejecución de texto)	§17.3.2.25
sdt (etiqueta de documento estructurado en línea)	§17.5.2.31
smartTag (etiqueta inteligente en línea)	§17.5.1.9
subDoc (delimitador para la ubicación del subdocumento)	§17.17.1.1

Atributos	Descripción
rsidDel (identificador de revisión para la eliminación de párrafos)	Especifica un identificador único que se usa para realizar un seguimiento de la sesión de edición cuando se eliminó el párrafo del documento principal. Todos los atributos rsid* de este documento con el mismo valor, si están presentes, indicarán que esas regiones se modificaron durante la misma sesión de edición (tiempo entre las acciones de guardado posteriores). Un productor puede optar por incrementar el valor de id. de guardado de revisión para indicar sesiones de edición posteriores para indicar el orden de las modificaciones en relación con otras modificaciones de este documento. Los valores posibles para este atributo se definen mediante el ST_LongHexNumber tipo simple (§17.18.50).
rsidP (identificador de revisión para las propiedades de párrafo)	Este atributo especifica un identificador único que se usa para realizar un seguimiento de la sesión de edición cuando las propiedades del párrafo se modificaron por última vez en este documento. Todos los atributos rsid* de este documento con el mismo valor, si están presentes, indicarán que esas regiones se modificaron durante la misma sesión de edición (tiempo entre las acciones de guardado posteriores). Un productor puede optar por incrementar el valor de id. de guardado de revisión para indicar sesiones de edición posteriores para indicar el orden de las modificaciones en relación con otras modificaciones de este documento. Los valores posibles para este atributo se definen mediante el ST_LongHexNumber tipo simple (§17.18.50).
rsidR (identificador de revisión para párrafo)	Este atributo especifica un identificador único que se usa para realizar un seguimiento de la sesión de edición cuando se agregó el párrafo al documento principal. Todos los atributos rsid* de este documento con el mismo valor, si están presentes, indicarán que esas regiones se modificaron durante la misma sesión de edición (tiempo entre las acciones de guardado posteriores). Un productor puede optar por incrementar el valor de id. de guardado de revisión para indicar sesiones de edición posteriores para indicar el orden de las modificaciones en relación con otras modificaciones de este documento. Los valores posibles para este atributo se definen mediante el ST_LongHexNumber tipo simple (§17.18.50).
rsidRDefault (identificador de revisión predeterminado para ejecuciones)	Este atributo especifica un identificador único usado para todas las ejecuciones de este párrafo que no declaran explícitamente un atributo rsidR. Este atributo permite a los consumidores optimizar las ubicaciones donde se escriben los valores rsid* en este documento. Todos los atributos rsid* de este documento con el mismo valor, si están presentes, indicarán que esas regiones se modificaron durante la misma sesión de edición (tiempo entre las acciones de guardado posteriores). Un productor puede optar por incrementar el valor de id. de guardado de revisión para indicar sesiones de edición posteriores para indicar el orden de las modificaciones en relación con otras modificaciones de este documento. Los valores posibles para este atributo se definen mediante el ST_LongHexNumber tipo simple (§17.18.50).
rsidRPr (identificador de revisión para el formato de glifo de párrafo)	Este atributo especifica un identificador único que se usa para realizar un seguimiento de la sesión de edición cuando el carácter de glifo que representa la marca de párrafo se modificó por última vez en el documento principal. Todos los atributos rsid* de este documento con el mismo valor, si están presentes, indicarán que esas regiones se modificaron durante la misma sesión de edición (tiempo entre las acciones de guardado posteriores). Un productor puede optar por incrementar el valor de id. de guardado de revisión para indicar sesiones de edición posteriores para indicar el orden de las modificaciones en relación con otras modificaciones de este documento. Los valores posibles para este atributo se definen mediante el ST_LongHexNumber tipo simple (§17.18.50).

[Nota: La definición del esquema XML W3C del modelo de contenido de este elemento (CT_P) se encuentra en §A.1. Fin de la nota]

ISO/IEC29500: 2008.

Constructores

Paragraph()	Inicializa una nueva instancia de la clase Paragraph.
Paragraph(IEnumerable<OpenXmlElement>)	Inicializa una nueva instancia de la clase Paragraph con los elementos secundarios especificados.
Paragraph(OpenXmlElement[])	Inicializa una nueva instancia de la clase Paragraph con los elementos secundarios especificados.
Paragraph(String)	Inicializa una nueva instancia de la clase Paragraph a partir de XML externo.

Propiedades

ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
ExtendedAttributes	Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement)
Features	Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement)
FirstChild	Obtiene el primer elemento secundario del elemento OpenXmlElement actual. (Heredado de OpenXmlCompositeElement)
HasAttributes	Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement)
HasChildren	Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlCompositeElement)
InnerText	Obtiene o establece los valores concatenados del nodo actual y todos sus elementos secundarios. (Heredado de OpenXmlCompositeElement)
InnerXml	Obtiene o establece el marcado que representa solo los nodos secundarios del nodo actual. (Heredado de OpenXmlCompositeElement)
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlCompositeElement)
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
MCAttributes	Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement)
NamespaceDeclarations	Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement)
NamespaceUri	Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
NoSpellError	noSpellErr, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: w14:noSpellErr
OpenXmlElementContext	Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement)
OuterXml	Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement)
ParagraphId	paraId, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: w14:paraId
ParagraphProperties	Propiedades de párrafo. Representa la siguiente etiqueta de elemento en el esquema: w:pPr.
Parent	Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement)
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
RsidParagraphAddition	Identificador de revisión para párrafo Representa el atributo siguiente en el esquema: w:rsidR
RsidParagraphDeletion	Identificador de revisión para la eliminación de párrafos Representa el atributo siguiente en el esquema: w:rsidDel
RsidParagraphMarkRevision	Identificador de revisión del formato de glifo de párrafo Representa el atributo siguiente en el esquema: w:rsidRPr
RsidParagraphProperties	Identificador de revisión de las propiedades de párrafo Representa el atributo siguiente en el esquema: w:rsidP
RsidRunAdditionDefault	Identificador de revisión predeterminado para ejecuciones Representa el atributo siguiente en el esquema: w:rsidRDefault
TextId	textId, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: w14:textId
XmlQualifiedName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)
XName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Agrega el elemento especificado al elemento si es un elemento secundario conocido. Esto agrega el elemento en la ubicación correcta según el esquema. (Heredado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement)
Ancestors()	Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement)
Ancestors<T>()	Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
Annotation(Type)	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotation<T>()	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations(Type)	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations<T>()	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Append(OpenXmlElement[])	Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
AppendChild<T>(T)	Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
ClearAllAttributes()	Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement)
Clone()	Crea un duplicado del nodo actual. (Heredado de OpenXmlElement)
CloneNode(Boolean)	Crea un duplicado de este nodo.
Descendants()	Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement)
Descendants<T>()	Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement)
Elements()	Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Elements<T>()	Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
ElementsAfter()	Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
ElementsBefore()	Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
GetAttribute(String, String)	Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement)
GetAttributes()	Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)
GetFirstChild<T>()	Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement)
InsertAt<T>(T, Int32)	Inserta el elemento especificado en el índice especificado de los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
LookupNamespace(String)	Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement)
LookupPrefix(String)	Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement)
NextSibling()	Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
NextSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
PrependChild<T>(T)	Inserta el elemento especificado al principio de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
PreviousSibling()	Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
PreviousSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
Remove()	Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement)
RemoveAllChildren()	Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement)
RemoveAnnotations(Type)	Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAnnotations<T>()	Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAttribute(String, String)	Quita el atributo del elemento actual. (Heredado de OpenXmlElement)
RemoveChild<T>(T)	Quita el elemento secundario especificado. (Heredado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Reemplaza uno de los elementos secundarios del elemento actual por otro elemento OpenXmlElement. (Heredado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()	Define la clase Paragraph. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es w:p. (Heredado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)