Paragraph Classe

Definição

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Define a classe Parágrafo.

Essa classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, seu nome qualificado é w:p.

public class Paragraph : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Paragraph = class
    inherit OpenXmlCompositeElement

Public Class Paragraph
Inherits OpenXmlCompositeElement

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

Paragraph

Exemplos

O exemplo de código a seguir abre um arquivo de processamento de palavras existente e grava texto nele.

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  

Comentários

[ISO/IEC 29500-1 1st Edition]

p (Parágrafo)

Esse elemento especifica um parágrafo de conteúdo no documento.

O conteúdo de um parágrafo em um documento WordprocessingML consiste em qualquer combinação dos quatro tipos de conteúdo a seguir:

• Propriedades do parágrafo

• Anotações (indicadores, comentários, revisões)

• Marcação personalizada

• Executar conteúdo de nível (campos, hiperlinks, execuções)

[Exemplo: considere um documento wordprocessingML básico com um único parágrafo. Este parágrafo seria expresso da seguinte maneira:

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

O elemento p é o contêiner para todo o conteúdo no parágrafo, que neste exemplo inclui uma execução de texto e um campo simples. exemplo final]

Elementos pai
body (§17.2.2); comentário (§17.13.4.2); customXml (§17.5.1.6); docPartBody (§17.12.6); nota de extremidade (§17.11.2); nota de rodapé (§17.11.10); ftr (§17.10.3); hdr (§17.10.4); sdtContent (§17.5.2.34); tc (§17.4.66)

Elementos filho	Subclause
bdo (Substituição Bidirecional)	§17.3.2.3
bookmarkEnd (Fim do Indicador)	§17.13.6.1
bookmarkStart (Início do Indicador)	§17.13.6.2
commentRangeEnd (Fim do Intervalo de Âncora de Comentários)	§17.13.4.3
commentRangeStart (Início do Intervalo de Âncora de Comentários)	§17.13.4.4
customXml (elemento XML personalizado de nível embutido)	§17.5.1.3
customXmlDelRangeEnd (extremidade de exclusão de marcação XML personalizada)	§17.13.5.4
customXmlDelRangeStart (início da exclusão de marcação XML personalizada)	§17.13.5.5
customXmlInsRangeEnd (extremidade de inserção de marcação XML personalizada)	§17.13.5.6
customXmlInsRangeStart (Início da Inserção de Marcação XML Personalizada)	§17.13.5.7
customXmlMoveFromRangeEnd (extremidade de origem de movimentação de marcação XML personalizada)	§17.13.5.8
customXmlMoveFromRangeStart (início da origem da movimentação de marcação XML personalizada)	§17.13.5.9
customXmlMoveToRangeEnd (Marcação XML Personalizada Mover Local de Destino)	§17.13.5.10
customXmlMoveToRangeStart (início da localização de destino de movimentação de marcação XML personalizada)	§17.13.5.11
del (Conteúdo de Execução Excluído)	§17.13.5.14
dir (Nível de incorporação bidirecional)	§17.3.2.8
fldSimple (Campo Simples)	§17.16.19
hiperlink (Hyperlink)	§17.16.22
ins (Conteúdo de Execução Inserido)	§17.13.5.18
moveFrom (mover conteúdo de execução de origem)	§17.13.5.22
moveFromRangeEnd (Mover contêiner de localização de origem – fim)	§17.13.5.23
moveFromRangeStart (Mover contêiner de localização de origem – iniciar)	§17.13.5.24
moveTo (mover conteúdo de execução de destino)	§17.13.5.25
moveToRangeEnd (mover contêiner de localização de destino – fim)	§17.13.5.27
moveToRangeStart (Mover contêiner de localização de destino – iniciar)	§17.13.5.28
oMath (Matemática do Office)	§22.1.2.77
oMathPara (Parágrafo de Matemática do Office)	§22.1.2.78
permEnd (fim da permissão de intervalo)	§17.13.7.1
permStart (Início da Permissão de Intervalo)	§17.13.7.2
pPr (propriedades do parágrafo)	§17.3.1.26
proofErr (âncora de erro de revisão)	§17.13.8.1
r (Execução de Texto)	§17.3.2.25
sdt (marca de documento estruturado em nível embutido)	§17.5.2.31
smartTag (marca inteligente de nível embutido)	§17.5.1.9
subDoc (Âncora para Local de Subdocumento)	§17.17.1.1

Atributos	Descrição
rsidDel (identificador de revisão para exclusão de parágrafo)	Especifica um identificador exclusivo usado para acompanhar a sessão de edição quando o parágrafo foi excluído do documento main. Todos os atributos rsid* ao longo deste documento com o mesmo valor, se presentes, deverão indicar que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre ações de salvamento subsequentes). Um produtor pode optar por incrementar o valor de ID de salvamento de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativas a outras modificações neste documento. Os valores possíveis para esse atributo são definidos pelo tipo ST_LongHexNumber simples (§17.18.50).
rsidP (Identificador de Revisão para Propriedades do Parágrafo)	Esse atributo especifica um identificador exclusivo usado para acompanhar a sessão de edição quando as propriedades do parágrafo foram modificadas pela última vez neste documento. Todos os atributos rsid* ao longo deste documento com o mesmo valor, se presentes, deverão indicar que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre ações de salvamento subsequentes). Um produtor pode optar por incrementar o valor de ID de salvamento de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativas a outras modificações neste documento. Os valores possíveis para esse atributo são definidos pelo tipo ST_LongHexNumber simples (§17.18.50).
rsidR (Identificador de Revisão para Parágrafo)	Esse atributo especifica um identificador exclusivo usado para acompanhar a sessão de edição quando o parágrafo foi adicionado ao documento main. Todos os atributos rsid* ao longo deste documento com o mesmo valor, se presentes, deverão indicar que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre ações de salvamento subsequentes). Um produtor pode optar por incrementar o valor de ID de salvamento de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativas a outras modificações neste documento. Os valores possíveis para esse atributo são definidos pelo tipo ST_LongHexNumber simples (§17.18.50).
rsidRDefault (Identificador de Revisão Padrão para Execuções)	Esse atributo especifica um identificador exclusivo usado para todas as execuções neste parágrafo que não declaram explicitamente um atributo rsidR. Esse atributo permite que os consumidores otimizem os locais em que os valores rsid* são gravados neste documento. Todos os atributos rsid* ao longo deste documento com o mesmo valor, se presentes, deverão indicar que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre ações de salvamento subsequentes). Um produtor pode optar por incrementar o valor de ID de salvamento de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativas a outras modificações neste documento. Os valores possíveis para esse atributo são definidos pelo tipo ST_LongHexNumber simples (§17.18.50).
rsidRPr (Identificador de Revisão para Formatação de Glifo do Parágrafo)	Esse atributo especifica um identificador exclusivo usado para acompanhar a sessão de edição quando o caractere glifo que representa a marca de parágrafo foi modificado pela última vez no documento main. Todos os atributos rsid* ao longo deste documento com o mesmo valor, se presentes, deverão indicar que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre ações de salvamento subsequentes). Um produtor pode optar por incrementar o valor de ID de salvamento de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativas a outras modificações neste documento. Os valores possíveis para esse atributo são definidos pelo tipo ST_LongHexNumber simples (§17.18.50).

[Observação: a definição de esquema XML W3C do modelo de conteúdo desse elemento (CT_P) está localizada em §A.1. nota final]

ISO/IEC29500: 2008.

Construtores

Paragraph()	Inicializa uma nova instância da classe Parágrafo.
Paragraph(IEnumerable<OpenXmlElement>)	Inicializa uma nova instância da classe Parágrafo com os elementos filho especificados.
Paragraph(OpenXmlElement[])	Inicializa uma nova instância da classe Parágrafo com os elementos filho especificados.
Paragraph(String)	Inicializa uma nova instância da classe Parágrafo do XML externo.

Propriedades

ChildElements	Obtém todos os nós filho do elemento atual. (Herdado de OpenXmlElement)
ExtendedAttributes	Obtém todos os atributos estendidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Essa coleção de recursos será somente leitura, mas herdará recursos de sua parte pai e pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro filho do elemento OpenXmlElement atual. (Herdado de OpenXmlCompositeElement)
HasAttributes	Obtém um valor que indica se o elemento atual tem atributos. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem elementos filho. (Herdado de OpenXmlCompositeElement)
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os seus filhos. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós filho do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último filho do elemento OpenXmlElement atual. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MCAttributes	Obtém ou define os atributos de compatibilidade de marcação. Retorna nulo se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement)
NamespaceDeclarations	Obtém todas as declarações de namespace definidas no elemento atual. Retornará um enumerador vazio se não houver nenhuma declaração de namespace. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do namespace do elemento atual. (Herdado de OpenXmlElement)
NoSpellError	noSpellErr, essa propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: w14:noSpellErr
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
OuterXml	Obtém a marcação que representa o elemento atual e todos os seus elementos filho. (Herdado de OpenXmlElement)
ParagraphId	paraId, essa propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: w14:paraId
ParagraphProperties	Propriedades do parágrafo. Representa a seguinte marca de elemento no esquema: w:pPr.
Parent	Obtém o elemento pai do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo namespace do elemento atual. (Herdado de OpenXmlElement)
RsidParagraphAddition	Identificador de Revisão para Parágrafo Representa o seguinte atributo no esquema: w:rsidR
RsidParagraphDeletion	Identificador de revisão para exclusão de parágrafo Representa o seguinte atributo no esquema: w:rsidDel
RsidParagraphMarkRevision	Identificador de revisão para formatação de glifo de parágrafo Representa o seguinte atributo no esquema: w:rsidRPr
RsidParagraphProperties	Identificador de revisão para propriedades de parágrafo Representa o seguinte atributo no esquema: w:rsidP
RsidRunAdditionDefault	Identificador de revisão padrão para execuções Representa o seguinte atributo no esquema: w:rsidRDefault
TextId	textId, essa propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: w14:textId
XmlQualifiedName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)
XName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Adiciona o elemento especificado ao elemento se ele for uma criança conhecida. Isso adiciona o elemento no local correto de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de namespace ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os ancestrais do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os ancestrais do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations(Type)	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations<T>()	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Acrescenta cada elemento de uma lista de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos até o final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao final da lista de nós filho do elemento atual. (Herdado de OpenXmlCompositeElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos. (Herdado de OpenXmlElement)
Clone()	Cria uma duplicata do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria uma duplicata desse nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumera todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os filhos do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os filhos do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos irmãos que seguem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos irmãos que precedem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da marca e o URI do namespace especificados. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento filho no tipo T. (Herdado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente após o elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)	Insere o elemento especificado no índice especificado dos filhos do elemento atual. (Herdado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual é exibido após um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual é exibido antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo namespace no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um uri de namespace no escopo do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum próximo elemento OpenXmlElement. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Retornará nulo (Nada no Visual Basic) se não houver o próximo OpenXmlElement. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de nós filho do elemento atual. (Herdado de OpenXmlCompositeElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual de seu pai. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos filho do elemento atual. (Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Remova todos os elementos filho do elemento atual que são do tipo T. (Herdado de OpenXmlElement)
RemoveAnnotations(Type)	Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAnnotations<T>()	Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAttribute(String, String)	Remove o atributo do elemento atual. (Herdado de OpenXmlElement)
RemoveChild<T>(T)	Remove o elemento filho especificado. (Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de namespace do prefixo especificado. Não removerá nada se não houver nenhum prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um dos elementos filho do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo será definido. Se o atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define uma série de atributos para o elemento. Se um atributo for um atributo conhecido, o valor do atributo será definido. Se um atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Salva o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Define a classe Parágrafo. Essa classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é w:p. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)