Como trabalhar com execuções

Artigo
01/21/2025

Este tópico aborda a classe Open XML SDK Run e como se relaciona com o esquema WordprocessingML Open XML File Format.

Execuções no WordprocessingML

O texto seguinte da especificação ISO/IEC 29500 apresenta o elemento de execução Open XML WordprocessingML.

O nível seguinte da hierarquia de documentos [após o parágrafo] é a execução, que define uma região de texto com um conjunto comum de propriedades. Uma execução é representada por um elemento r, que permite ao produtor combinar quebras, estilos ou propriedades de formatação, aplicando as mesmas informações a todas as partes da execução.

Tal como um parágrafo pode ter propriedades, também pode ser executada. Todos os elementos dentro de um elemento r têm as respetivas propriedades controladas por um elemento de propriedades de execução rPr opcional correspondente, que tem de ser o primeiro subordinado do elemento r. Por sua vez, o elemento rPr é um contentor para um conjunto de elementos de propriedade que são aplicados aos restantes subordinados do elemento r. Os elementos dentro do elemento de contentor rPr permitem ao consumidor controlar se o texto nos seguintes elementos t está a negrito, sublinhado ou visível, por exemplo. Alguns exemplos de propriedades de execução são negrito, limite, estilo de carateres, cor, tipo de letra, tamanho do tipo de letra, itálico, kerning, desativar a ortografia/gramática marcar, sombreado, maiúsculas pequenas, rasurado, direção do texto e sublinhado.

A tabela seguinte lista as classes de SDK Open XML mais comuns utilizadas ao trabalhar com execuções.

Elemento XML	Abrir Classe SDK XML
p	Parágrafo
rPr	RunProperties
t	Texto

Executar Classe

A classe Open XML SDK Run representa o elemento de execução <r> definido no esquema Open XML File Format para documentos wordprocessingML, conforme abordado acima. Utilize um objeto Executar para manipular um elemento individual <r> num documento do WordprocessingML.

Classe RunProperties

No WordprocessingML, as propriedades de um elemento de execução são especificadas com o elemento propriedades <rPr> de execução. Alguns exemplos de propriedades de execução são negrito, limite, estilo de carateres, cor, tipo de letra, tamanho do tipo de letra, itálico, kerning, desativar a ortografia/gramática marcar, sombreado, maiúsculas pequenas, rasurado, direção do texto e sublinhado. Utilize um RunProperties objeto para definir as propriedades de uma execução num documento do WordprocessingML.

Objeto de Texto

Com o <r> elemento , o elemento de texto (<t>) é o contentor do texto que compõe o conteúdo do documento. A classe SDK Text OXML representa o <t> elemento . Utilize um objeto texto para colocar texto num documento de processamento do Word.

Open XML SDK Code Example

O código seguinte adiciona texto à main superfície do documento do WordprocessingML especificado. Um objeto Executar demarca uma região de texto no parágrafo e, em seguida, é utilizado um objeto RunProperties para aplicar formatação de negrito à execução.

C#
Visual Basic

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

static void WriteToWordDoc(string filepath, string txt)
{
    // Open a WordprocessingDocument for editing using the filepath.
    using (WordprocessingDocument wordprocessingDocument = WordprocessingDocument.Open(filepath, true))
    {
        // Assign a reference to the existing document body.
        MainDocumentPart mainDocumentPart = wordprocessingDocument.MainDocumentPart ?? wordprocessingDocument.AddMainDocumentPart();
        mainDocumentPart.Document ??= new Document();
        Body body = mainDocumentPart.Document.Body ?? mainDocumentPart.Document.AppendChild(new Body());

        // Add new text.
        Paragraph para = body.AppendChild(new Paragraph());
        Run run = para.AppendChild(new Run());

        // Apply bold formatting to the run.
        RunProperties runProperties = run.AppendChild(new RunProperties(new Bold()));
        run.AppendChild(new Text(txt));
    }
}

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

Module MyModule

    Sub Main(args As String())
        WriteToWordDoc(args(0), args(1))
    End Sub

    Public Sub WriteToWordDoc(ByVal filepath As String, ByVal txt As String)
        ' Open a WordprocessingDocument for editing using the filepath.
        Using wordprocessingDocument As WordprocessingDocument =
            WordprocessingDocument.Open(filepath, True)
            ' Assign a reference to the existing document body.
            Dim body As Body = wordprocessingDocument.MainDocumentPart.Document.Body

            ' Add new text.
            Dim para As Paragraph = body.AppendChild(New Paragraph())
            Dim run As Run = para.AppendChild(New Run())

            ' Apply bold formatting to the run.
            Dim runProperties As RunProperties = run.AppendChild(New RunProperties(New Bold()))
            run.AppendChild(New Text(txt))
        End Using
    End Sub
End Module

Quando este código é executado, o seguinte XML é escrito no documento wordprocessingML especificado no código anterior.

    <w:p>
      <w:r>
        <w:rPr>
          <w:b />
        </w:rPr>
        <w:t>String from WriteToWordDoc method.</w:t>
      </w:r>
    </w:p>

Confira também

Acerca do SDK Open XML para o Office

Como trabalhar com parágrafos

Como: Aplicar um estilo a um parágrafo num documento de processamento de palavras

Como: Abrir e adicionar texto a um documento de processamento de palavras

Compartilhar via