How to Add Style to Text in DOCX with C#

Updated: 4 de junho de 2026

A classe TextStyle do IronWord permite que desenvolvedores .NET apliquem formatação de texto profissional a documentos Word programaticamente, incluindo fontes, cores, negrito, itálico, sublinhado e mais. Seja para gerar relatórios, criar modelos ou automatizar a criação de documentos, o IronWord oferece ferramentas de formatação abrangentes que replicam as opções de formatação do Microsoft Word.

Início rápido: Estilize texto em DOCX com C#

1Install IronWord with NuGet Package Manager
PM > Install-Package IronWord
```
Install-Package IronWord
```

2Copie e execute este trecho de código.

// Quick example
using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument doc = new WordDocument();

// Create a Run with styled text
Run textRun = new Run(new TextContent("Styled text"));

// Apply styling properties to the Run
textRun.Style = new TextStyle()
{
    IsBold = true,
    Color = Color.Red,
    FontSize = 16,
    TextFont = new Font()
    {
        FontFamily = "Arial"
    }
};

// Create paragraph and add the styled Run
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);

// Add paragraph to document and save
doc.AddParagraph(paragraph);
doc.SaveAs("styled.docx");

// Quick example
using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument doc = new WordDocument();

// Create a Run with styled text
Run textRun = new Run(new TextContent("Styled text"));

// Apply styling properties to the Run
textRun.Style = new TextStyle()
{
    IsBold = true,
    Color = Color.Red,
    FontSize = 16,
    TextFont = new Font()
    {
        FontFamily = "Arial"
    }
};

// Create paragraph and add the styled Run
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);

// Add paragraph to document and save
doc.AddParagraph(paragraph);
doc.SaveAs("styled.docx");

3Implante para testar em seu ambiente de produção.

Comece a usar IronWord em seu projeto hoje com uma avaliação gratuita

Fluxo de trabalho mínimo (5 etapas)

Instale a biblioteca IronWord C#
Crie um objeto Run contendo TextContent
Aplique TextStyle ao Run com propriedades como FontSize , IsBold e Cor
Adicione o Run estilizado a um Paragraph usando AddChild
Salve o documento com os estilos aplicados.

Como adiciono estilo de texto a um arquivo DOCX?

Aplicar estilos de texto no IronWord requer o uso do padrão de envoltório Run. Crie um objeto WordDocument, então crie um objeto Run contendo TextContent com seu texto. Aplique um TextStyle ao Run (não no TextContent) usando propriedades como IsBold, Color ou FontSize.

Uma vez estilizado, adicione o Run a um Paragraph usando AddChild, insira o parágrafo no documento e salve o resultado. Esta abordagem fornece controle programático sobre a formatação de texto para cenários de geração de documentos automatizados que exigem estilização consistente.

Observe: A hierarquia de documentos do IronWord segue a estrutura: Document → DocumentSection → Paragraph → Run → TextContent. Estilos são aplicados ao nível Run, não no TextContent diretamente.

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument("sample.docx");

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));

// Configure text style settings
textRun.Style = new TextStyle()
{
    FontSize = 24, // Text Size is 24
    TextFont = new Font()
    {
        FontFamily = "Calibri" // Text Font is "Calibri"
    },
    Color = Color.Red, // Set text color to red
    IsBold = true,     // Make text bold
    IsItalic = true,   // Make text italic
    Underline = new Underline(), // Have an underline
    Strike = StrikeValue.DoubleStrike, // Double strike-through
};

Paragraph paragraph = new Paragraph();

// Add text to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("add-text-style.docx");

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument("sample.docx");

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));

// Configure text style settings
textRun.Style = new TextStyle()
{
    FontSize = 24, // Text Size is 24
    TextFont = new Font()
    {
        FontFamily = "Calibri" // Text Font is "Calibri"
    },
    Color = Color.Red, // Set text color to red
    IsBold = true,     // Make text bold
    IsItalic = true,   // Make text italic
    Underline = new Underline(), // Have an underline
    Strike = StrikeValue.DoubleStrike, // Double strike-through
};

Paragraph paragraph = new Paragraph();

// Add text to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("add-text-style.docx");

Que resultado isso irá gerar?

Interface do Microsoft Word mostrando a guia Layout e o documento com formatação de texto riscado em vermelho aplicada.

A classe TextStyle oferece opções essenciais de formatação incluindo propriedades de fonte, cor de texto, negrito, itálico e sublinhado. Observe que FontSize é configurado no nível TextStyle (não dentro de Font), enquanto FontFamily é definido dentro da propriedade TextFont. O objeto Run envolve o TextContent e mantém o estilo, seguindo o padrão de hierarquia de documentos do IronWord. O exemplo demonstra como múltiplas propriedades de estilização se combinam para criar um texto ricamente formatado quando aplicado a um Run.

Que estilos específicos posso adicionar?

Como faço para alterar a cor do texto?

A propriedade Color no TextStyle define a cor do texto usando cores predefinidas de IronWord.Models.Color ou valores hexadecimais personalizados. Isso enfatiza conteúdo específico ou combina com as cores da marca. IronWord suporta uma ampla gama de cores, incluindo vermelho, azul, verde, oliva, marinho e bordô.

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add colored text
Run textRun = new Run(new TextContent("This text is olive-colored!"));
textRun.Style = new TextStyle()
{
    Color = IronWord.Models.Color.Olive // defining text to be colored olive
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("colored-text.docx");

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add colored text
Run textRun = new Run(new TextContent("This text is olive-colored!"));
textRun.Style = new TextStyle()
{
    Color = IronWord.Models.Color.Olive // defining text to be colored olive
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("colored-text.docx");

Imports IronWord
Imports IronWord.Models

' Create document
Dim doc As New WordDocument()

' Add colored text
Dim textRun As New Run(New TextContent("This text is olive-colored!"))
textRun.Style = New TextStyle() With {
    .Color = IronWord.Models.Color.Olive ' defining text to be colored olive
}

Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)

' Save document
doc.SaveAs("colored-text.docx")

Imports IronWord
Imports IronWord.Models

' Create document
Dim doc As New WordDocument()

' Add colored text
Dim textRun As New Run(New TextContent("This text is olive-colored!"))
textRun.Style = New TextStyle() With {
    .Color = IronWord.Models.Color.Olive ' defining text to be colored olive
}

Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)

' Save document
doc.SaveAs("colored-text.docx")

Qual a aparência do texto colorido?

Microsoft Word exibindo formatação de texto na cor verde-oliva, com a guia Página Inicial na faixa de opções, mostrando as ferramentas de fonte e parágrafo.

Como faço para definir a família e o tamanho da fonte?

Personalize a aparência do texto com a propriedade TextFont. Defina FontFamily para qualquer nome de fonte instalada (por exemplo, "Arial", "Times New Roman") e FontSize em pontos. Isso estabelece uma hierarquia visual e garante a legibilidade em diferentes dispositivos e plataformas.

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add text with custom font family and size
Run textRun = new Run(new TextContent("This text uses Arial at 24pt!"));
textRun.Style = new TextStyle()
{
    FontSize = 24,  // Set font size in points
    TextFont = new IronWord.Models.Font()
    {
        FontFamily = "Arial"  // Set font family
    }
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("font-styled-text.docx");

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add text with custom font family and size
Run textRun = new Run(new TextContent("This text uses Arial at 24pt!"));
textRun.Style = new TextStyle()
{
    FontSize = 24,  // Set font size in points
    TextFont = new IronWord.Models.Font()
    {
        FontFamily = "Arial"  // Set font family
    }
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("font-styled-text.docx");

Imports IronWord
Imports IronWord.Models

' Create document
Dim doc As New WordDocument()

' Add text with custom font family and size
Dim textRun As New Run(New TextContent("This text uses Arial at 24pt!"))
textRun.Style = New TextStyle() With {
    .FontSize = 24,  ' Set font size in points
    .TextFont = New IronWord.Models.Font() With {
        .FontFamily = "Arial"  ' Set font family
    }
}

Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)

' Save document
doc.SaveAs("font-styled-text.docx")

Imports IronWord
Imports IronWord.Models

' Create document
Dim doc As New WordDocument()

' Add text with custom font family and size
Dim textRun As New Run(New TextContent("This text uses Arial at 24pt!"))
textRun.Style = New TextStyle() With {
    .FontSize = 24,  ' Set font size in points
    .TextFont = New IronWord.Models.Font() With {
        .FontFamily = "Arial"  ' Set font family
    }
}

Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)

' Save document
doc.SaveAs("font-styled-text.docx")

Como fica a estilização de fontes personalizadas?

Microsoft Word exibindo a fonte Arial de 24 pontos selecionada na barra de ferramentas com um texto de exemplo formatado.

Como faço para deixar o texto em negrito?

Defina a propriedade IsBold para true para tornar o texto Bold. Texto Bold é comumente usado para títulos, ênfase ou destacar informações importantes. Combinado com outras propriedades de estilização, texto Bold cria hierarquia visual e melhora a legibilidade.

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add bold text
Run textRun = new Run(new TextContent("this is bold!"));
textRun.Style = new TextStyle()
{
    IsBold = true  // Make text bold
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("bold-text.docx");

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add bold text
Run textRun = new Run(new TextContent("this is bold!"));
textRun.Style = new TextStyle()
{
    IsBold = true  // Make text bold
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("bold-text.docx");

Imports IronWord
Imports IronWord.Models

' Create document
Dim doc As New WordDocument()

' Add bold text
Dim textRun As New Run(New TextContent("this is bold!"))
textRun.Style = New TextStyle() With {
    .IsBold = True ' Make text bold
}

Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)

' Save document
doc.SaveAs("bold-text.docx")

Imports IronWord
Imports IronWord.Models

' Create document
Dim doc As New WordDocument()

' Add bold text
Dim textRun As New Run(New TextContent("this is bold!"))
textRun.Style = New TextStyle() With {
    .IsBold = True ' Make text bold
}

Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)

' Save document
doc.SaveAs("bold-text.docx")

Qual a aparência do texto em negrito?

Interface do Microsoft Word mostrando formatação de texto em negrito com a mensagem "Isto está em negrito!" exibida no documento.

Como faço para deixar o texto em itálico?

Defina a propriedade IsItalic para true para estilização Italic. Texto Italic é tipicamente usado para ênfase, títulos, palavras estrangeiras ou termos técnicos. Esta formatação sutil diferencia elementos de texto sem o peso visual da formatação Bold.

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add italic text
Run textRun = new Run(new TextContent("this is italic."));
textRun.Style = new TextStyle()
{
    IsItalic = true  // Make text italic
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("italic-text.docx");

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Add italic text
Run textRun = new Run(new TextContent("this is italic."));
textRun.Style = new TextStyle()
{
    IsItalic = true  // Make text italic
};

Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("italic-text.docx");

Imports IronWord
Imports IronWord.Models

' Create document
Dim doc As New WordDocument()

' Add italic text
Dim textRun As New Run(New TextContent("this is italic."))
textRun.Style = New TextStyle() With {
    .IsItalic = True  ' Make text italic
}

Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)

' Save document
doc.SaveAs("italic-text.docx")

Imports IronWord
Imports IronWord.Models

' Create document
Dim doc As New WordDocument()

' Add italic text
Dim textRun As New Run(New TextContent("this is italic."))
textRun.Style = New TextStyle() With {
    .IsItalic = True  ' Make text italic
}

Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)

' Save document
doc.SaveAs("italic-text.docx")

Qual é a aparência do texto em itálico?

Documento do Word exibindo texto em itálico com as opções de formatação da guia Página Inicial visíveis na faixa de opções.

Quais são as propriedades de estilo disponíveis?

O IronWord oferece propriedades de estilo abrangentes, semelhantes às opções de formatação do Microsoft Word. Essas propriedades se combinam para criar uma formatação de texto complexa que atende aos padrões de documentos profissionais.

Método de estilização	Descrição	Exemplo
`TextFont`	Personaliza a aparência do texto com um objeto `Font` , definindo a família da fonte. Observação: `FontSize` é definido no nível `TextStyle` , não dentro `Font` .	`textRun.Style = new TextStyle() { FontSize = 24, TextFont = new Font() { FontFamily = 'Calibri' } };`
`Cor`	Define a cor do texto usando cores predefinidas de IronWord.Models.Color ou valores hexadecimais personalizados.	`textRun.Style.Color = IronWord.Models.Color.Red;`
`IsBold`	Deixa o texto `Negrito` quando definido como `true`, comumente usado para títulos ou ênfase.	`textRun.Style.IsBold = true;`
`IsItalic`	Aplica estilo `Itálico` ao texto quando definido como `true`, tipicamente usado para ênfase ou títulos.	`textRun.Style.IsItalic = true;`
`Sublinhar`	Adiciona um `Sublinhado` ao texto usando um `Sublinhar` object com vários estilos de sublinhado.	`textRun.Style.Underline = new Underline();`
`Riscar`	Aplica tachado ao texto usando `StrikeValue` enum (`Riscar` ou `DoubleStrike`).	`textRun.Style.Strike = StrikeValue.Strike;`
`Capitais`	Aplica efeitos de capitalização ao texto, convertendo todos os caracteres para exibição em maiúsculas.	`textRun.Style.Caps = true;`
`EscalaDeCaracteres`	Ajusta a largura proporcional dos caracteres como uma porcentagem do seu tamanho normal.	`textRun.Style.CharacterScale = 150;`
`Emboss`	Aplica um efeito de relevo ao texto, criando uma aparência elevada.	`textRun.Style.Emboss = true;`
`Ênfase`	Adiciona marcas de ênfase ao texto estilizado usando os valores da enumeração `EmphasisMarkValues` .	`textRun.Style.Emphasis = EmphasisMarkValues.Dot;`
`LineSpacing`	Controla o espaçamento entre linhas de texto para melhorar a legibilidade usando um objeto `LineSpacing` .	`textRun.Style.LineSpacing = new LineSpacing() { Value = 1.5 };`
`Contorno`	Renderiza o texto com um efeito de contorno, exibindo apenas as bordas dos caracteres.	`textRun.Style.Outline = true;`
`Sombreamento`	Aplica cor de fundo ou sombreamento ao texto usando um objeto `Sombreamento` .	`textRun.Style.Shading = new Shading() { Color = Color.Yellow };`
`Minúsculas`	Converte letras minúsculas em letras maiúsculas versalete, mantendo a distinção entre maiúsculas e minúsculas.	`textRun.Style.SmallCaps = true;`
`VerticalPosition`	Ajusta o posicionamento vertical do texto em relação à sua linha de base, medido em pontos.	`textRun.Style.VerticalPosition = 5.0;`
`AlinhamentoVerticalDoTexto`	Posiciona o texto verticalmente dentro do seu contêiner usando a enumeração `VerticalPositionValues` .	`textRun.Style.VerticalTextAlignment = VerticalPositionValues.Superscript;`

Combinando vários estilos

O poder de estilização de texto do IronWord vem da combinação de múltiplas propriedades para alcançar formatação complexa. Aqui está um exemplo que demonstra um texto formatado profissionalmente, combinando várias propriedades de estilo:

using IronWord;
using IronWord.Models;

// Create a new document
WordDocument doc = new WordDocument();

// Create richly formatted header text using Run
Run headerRun = new Run(new TextContent("Professional Document Header"));
headerRun.Style = new TextStyle()
{
    FontSize = 28,
    TextFont = new Font()
    {
        FontFamily = "Georgia"
    },
    Color = Color.DarkBlue,
    IsBold = true,
    SmallCaps = true,
    Underline = new Underline(),
    CharacterScale = 110,  // Slightly expand character width
    Shading = new Shading()
    {
        Color = Color.LightGray  // Light background
    }
};

// Add header to document using AddChild for styled Run
Paragraph headerParagraph = new Paragraph();
headerParagraph.AddChild(headerRun);
doc.AddParagraph(headerParagraph);

// Create body text with different styling
Run bodyRun = new Run(new TextContent("This is professionally formatted body text with custom styling."));
bodyRun.Style = new TextStyle()
{
    FontSize = 11,
    TextFont = new Font()
    {
        FontFamily = "Calibri"
    },
    Color = Color.Black
};

Paragraph bodyParagraph = new Paragraph();
bodyParagraph.AddChild(bodyRun);
doc.AddParagraph(bodyParagraph);

// Save the document
doc.SaveAs("professional-document.docx");

using IronWord;
using IronWord.Models;

// Create a new document
WordDocument doc = new WordDocument();

// Create richly formatted header text using Run
Run headerRun = new Run(new TextContent("Professional Document Header"));
headerRun.Style = new TextStyle()
{
    FontSize = 28,
    TextFont = new Font()
    {
        FontFamily = "Georgia"
    },
    Color = Color.DarkBlue,
    IsBold = true,
    SmallCaps = true,
    Underline = new Underline(),
    CharacterScale = 110,  // Slightly expand character width
    Shading = new Shading()
    {
        Color = Color.LightGray  // Light background
    }
};

// Add header to document using AddChild for styled Run
Paragraph headerParagraph = new Paragraph();
headerParagraph.AddChild(headerRun);
doc.AddParagraph(headerParagraph);

// Create body text with different styling
Run bodyRun = new Run(new TextContent("This is professionally formatted body text with custom styling."));
bodyRun.Style = new TextStyle()
{
    FontSize = 11,
    TextFont = new Font()
    {
        FontFamily = "Calibri"
    },
    Color = Color.Black
};

Paragraph bodyParagraph = new Paragraph();
bodyParagraph.AddChild(bodyRun);
doc.AddParagraph(bodyParagraph);

// Save the document
doc.SaveAs("professional-document.docx");

Essa abordagem de formatação abrangente cria documentos que mantêm uma identidade visual consistente e uma aparência profissional em todo o processo de geração de documentos da sua aplicação.

Perguntas frequentes

Como posso aplicar formatação de texto a documentos do Word programaticamente em C#?

A classe TextStyle do IronWord permite aplicar formatação de texto profissional, incluindo fontes, cores, negrito, itálico e sublinhado. Basta criar um objeto TextContent com o seu texto, aplicar um TextStyle com as propriedades desejadas, adicioná-lo a um parágrafo e salvar o documento.

Quais são os passos básicos para formatar texto em arquivos DOCX?

Para formatar texto com o IronWord: 1) Instale o IronWord via NuGet, 2) Crie um objeto WordDocument, 3) Crie um TextContent com seu texto, 4) Aplique propriedades de estilo de texto, como fonte, cor ou negrito, 5) Adicione o texto a um parágrafo e salve.

Quais opções de formatação de texto estão disponíveis?

A classe TextStyle do IronWord oferece opções essenciais de formatação, incluindo propriedades da fonte (FontFamily e FontSize), cor do texto, negrito, itálico, sublinhado e tachado. Essas opções podem ser combinadas para criar textos com formatação avançada.

Como faço para alterar a família e o tamanho da fonte do texto?

Use a propriedade TextFont em TextStyle para especificar a família e o tamanho da fonte. Defina FontFamily para fontes como 'Arial' ou 'Times New Roman' e FontSize para o tamanho de ponto desejado, como 16 para textos maiores.

Posso aplicar vários estilos de texto simultaneamente?

Sim, o IronWord permite combinar várias propriedades de estilo em um único objeto TextStyle. Você pode aplicar negrito, itálico, cor e alterações de fonte simultaneamente para criar formatação de texto complexa.

Como faço para alterar a cor do texto em documentos do Word usando C#?

A propriedade Color do TextStyle do IronWord permite definir a cor do texto usando cores predefinidas de IronWord.Models.Color ou valores hexadecimais personalizados. Esse recurso ajuda a enfatizar conteúdo específico ou a combinar as cores da marca em seus documentos.

What property is used to italicize text in IronWord?

The IsItalic property is used within the TextStyle class to apply italic formatting to text in IronWord documents.

How do I apply an underline to text using IronWord?

To underline text in an IronWord document, create a new Underline object and assign it to the Underline property in the TextStyle class for the Run object containing your text.

Can I apply complex text styling using multiple properties in IronWord?

Yes, IronWord enables complex text styling by combining multiple TextStyle properties, such as FontSize, Color, IsBold, and Underline, to create richly formatted text in Word documents.

What is the benefit of using IronWord for text styling in DOCX documents?

IronWord offers programmatic control over text styling in DOCX documents, allowing developers to automate document creation while ensuring consistent and professional formatting similar to Microsoft Word.

Ahmad Sohail

Converse agora mesmo com a equipe de engenharia.

Desenvolvedor Full Stack

Ahmad é um desenvolvedor full-stack com uma sólida base em C#, Python e tecnologias web. Ele tem um grande interesse em construir soluções de software escaláveis e gosta de explorar como design e funcionalidade se encontram em aplicações do mundo real.

...