Paragraph Classe

Definição

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Define a Classe de Parágrafo.

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

Quando o objeto é serializado como xml, o 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 seguinte exemplo de código abre um ficheiro de processamento de palavras existente e escreve texto no mesmo.

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)

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

Os conteúdos de um parágrafo num documento wordprocessingML devem consistir em qualquer combinação dos seguintes quatro tipos de conteúdo:

• Propriedades do parágrafo

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

• Marcação personalizada

• Conteúdo de nível de execução (campos, hiperligações, execuções)

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

<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 contentor 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
corpo (}17.2.2); comentário (}17.13.4.2); customXml (}17.5.1.6); docPartBody (}17.12.6); nota de fim (}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	Subclautilizar
bdo (Substituição Bidirecional)	§17.3.2.3
bookmarkEnd (Fim do Marcador)	§17.13.6.1
bookmarkStart (Início do Marcador)	§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 Inline)	§17.5.1.3
customXmlDelRangeEnd (Fim da Eliminação da Marcação XML Personalizada)	§17.13.5.4
customXmlDelRangeStart (Início de Eliminação de Marcação XML Personalizada)	§17.13.5.5
customXmlInsRangeEnd (Fim da 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 (Fim da Origem de Movimentação de Marcação XML Personalizada)	§17.13.5.8
customXmlMoveFromRangeStart (Início da Origem de Movimentação de Marcação XML Personalizada)	§17.13.5.9
customXmlMoveToRangeEnd (Fim da Localização de Destino de Movimentação de Margem XML Personalizada)	§17.13.5.10
customXmlMoveToRangeStart (Início da Localização de Destino de Movimentação de Markup XML Personalizada)	§17.13.5.11
del (Conteúdo de Execução Eliminado)	§17.13.5.14
dir (Nível de Incorporação Bidirecional)	§17.3.2.8
fldSimple (Campo Simples)	§17.16.19
hiperligação (Hiperligação)	§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 (Move Source Location Container - End)	§17.13.5.23
moveFromRangeStart (Move Source Location Container - Start)	§17.13.5.24
moveTo (Mover Conteúdo de Execução de Destino)	§17.13.5.25
moveToRangeEnd (Mover Contentor de Localização de Destino - Fim)	§17.13.5.27
moveToRangeStart (Mover Contentor de Localização de Destino – Iniciar)	§17.13.5.28
oMath (Matemática do Office)	§22.1.2.77
oMathPara (Parágrafo matemático do Office)	§22.1.2.78
permEnd (Fim da Permissão do Intervalo)	§17.13.7.1
permStart (Início da Permissão do Intervalo)	§17.13.7.2
pPr (Propriedades do Parágrafo)	§17.3.1.26
proofErr (Âncora de Erro de Verificação Linguística)	§17.13.8.1
r (Execução de Texto)	§17.3.2.25
sdt (Etiqueta de Documento Estruturado ao Nível Inline)	§17.5.2.31
smartTag (Etiqueta Inteligente de Nível Inline)	§17.5.1.9
subDoc (Âncora para Localização do Subdocumento)	§17.17.1.1

Atributos	Descrição
rsidDel (Identificador de Revisão para Eliminação de Parágrafo)	Especifica um identificador exclusivo utilizado para controlar a sessão de edição quando o parágrafo foi eliminado do main documento. Todos os atributos rsid* ao longo deste documento com o mesmo valor, se estiverem presentes, indicarão que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre as ações de gravação subsequentes). Um produtor pode optar por incrementar o valor de ID de gravação de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativamente a outras modificações neste documento. Os valores possíveis para este atributo são definidos pelo ST_LongHexNumber tipo simples (}17.18.50).
rsidP (Identificador de Revisão para Propriedades de Parágrafo)	Este atributo especifica um identificador exclusivo utilizado para controlar 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 estiverem presentes, indicarão que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre as ações de gravação subsequentes). Um produtor pode optar por incrementar o valor de ID de gravação de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativamente a outras modificações neste documento. Os valores possíveis para este atributo são definidos pelo ST_LongHexNumber tipo simples (}17.18.50).
rsidR (Identificador de Revisão para Parágrafo)	Este atributo especifica um identificador exclusivo utilizado para controlar a sessão de edição quando o parágrafo foi adicionado ao main documento. Todos os atributos rsid* ao longo deste documento com o mesmo valor, se estiverem presentes, indicarão que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre as ações de gravação subsequentes). Um produtor pode optar por incrementar o valor de ID de gravação de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativamente a outras modificações neste documento. Os valores possíveis para este atributo são definidos pelo ST_LongHexNumber tipo simples (}17.18.50).
rsidRDefault (Identificador de Revisão Predefinido para Execuções)	Este atributo especifica um identificador exclusivo utilizado para todas as execuções neste parágrafo que não declaram explicitamente um atributo rsidR. Este atributo permite aos consumidores otimizar as localizações onde os valores rsid* são escritos neste documento. Todos os atributos rsid* ao longo deste documento com o mesmo valor, se estiverem presentes, indicarão que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre as ações de gravação subsequentes). Um produtor pode optar por incrementar o valor de ID de gravação de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativamente a outras modificações neste documento. Os valores possíveis para este atributo são definidos pelo ST_LongHexNumber tipo simples (}17.18.50).
rsidRPr (Identificador de Revisão para Formatação de Glyph de Parágrafo)	Este atributo especifica um identificador exclusivo utilizado para controlar a sessão de edição quando o caráter 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 estiverem presentes, indicarão que essas regiões foram modificadas durante a mesma sessão de edição (tempo entre as ações de gravação subsequentes). Um produtor pode optar por incrementar o valor de ID de gravação de revisão para indicar sessões de edição subsequentes para indicar a ordem das modificações relativamente a outras modificações neste documento. Os valores possíveis para este atributo são definidos pelo ST_LongHexNumber tipo simples (}17.18.50).

[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_P) está localizada em {A.1. nota de fim]

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 subordinados especificados.
Paragraph(OpenXmlElement[])	Inicializa uma nova instância da classe Parágrafo com os elementos subordinados especificados.
Paragraph(String)	Inicializa uma nova instância da classe Parágrafo do XML externo.

Propriedades

ChildElements	Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement)
ExtendedAttributes	Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro elemento subordinado 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 subordinados. (Herdado de OpenXmlCompositeElement)
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os respetivos subordinados. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós subordinados do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último elemento subordinado do elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir 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 markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement)
NamespaceDeclarations	Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
NoSpellError	noSpellErr, esta 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 respetivos elementos subordinados. (Herdado de OpenXmlElement)
ParagraphId	paraId, esta 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 etiqueta de elemento no esquema: w:pPr.
Parent	Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo de espaço de nomes 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 Eliminação de Parágrafos Representa o seguinte atributo no esquema: w:rsidDel
RsidParagraphMarkRevision	Identificador de Revisão para Formatação de Glyph 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 Predefinido para Execuções Representa o seguinte atributo no esquema: w:rsidRDefault
TextId	textId, esta 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 for um subordinado conhecido. Esta ação adiciona o elemento na localização correta de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado a partir 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 fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement)
Clone()	Cria um duplicado do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria um duplicado deste nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento subordinado 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 subordinados 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 aparece depois de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo do espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Remova todos os elementos subordinados 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 subordinado especificado. (Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um dos elementos subordinados 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 é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Define a Classe de Parágrafo. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é w:p. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)