Primeiros passos com o IronWord

Name: IronWord
Brand: Iron Software
Availability: InStock

Updated: 11 de junho de 2025

IronWord: Biblioteca de documentos Word for .NET

IronWord é uma biblioteca de documentos Word desenvolvida pela Iron Software. O IronWord se destaca por fornecer funcionalidades robustas para trabalhar com documentos do Word em aplicações .NET .

Carregar, manipular e salvar documentos Word e Docx.
PageSetup: Configuração de tamanho de papel, orientação de página, margens e cor de fundo.
TextRun: Tratamento de conteúdo de texto, estilos, divisão, adição de texto e inclusão de imagens.
TextStyle: Gerenciamento de família de fontes, tamanho, cor, negrito, itálico, tachado, sublinhado, sobrescrito e subscrito.
Paragraph: Adição de execuções de texto, imagens, formas, definição de estilos, alinhamentos, listas com marcadores e listas numeradas.
Table: Manipulação da estrutura de tabelas, incluindo adição de linhas, obtenção e configuração de valores de células, remoção de linhas, mesclagem de células e mais.
Image: Carregamento de imagens de arquivos ou streams, configuração de texto envolvido, deslocamento de posição, largura, altura e outras propriedades.
Shape: Configuração de texto envolvido, deslocamento de posição, largura, altura, tipo de forma e rotação.

Biblioteca C# para documentos do Word em .NET

Baixe a biblioteca C# para manipulação de documentos DOCX.
Criar e modificar documentos do Word e DOCX
Adicione estruturas de documento, como parágrafos, seções e tabelas.
Adicione elementos ao documento, como blocos de texto, imagens e formas.
Estilize os elementos do documento com facilidade.

Instalação

Biblioteca IronWord

A instalação do IronWord é rápida e fácil. Você pode instalar o pacote usando o NuGet com o seguinte comando:

PM > Install-Package IronWord

Install-Package IronWord

Alternativamente, faça o download diretamente do site oficial do IronWord no NuGet .

Uma vez instalado, você pode começar adicionando using IronWord; ao topo do seu arquivo de código C#.

Aplicando a chave de licença

Em seguida, aplique uma licença válida ou chave de teste ao IronWord, atribuindo a chave de licença à propriedade LicenseKey da classe License. Inclua o seguinte código logo após a declaração de importação, antes de usar qualquer método do IronWord :

using IronWord;

// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

using IronWord;

// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

Imports IronWord

' Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"

Imports IronWord

' Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"

Exemplos de código

Vamos explorar alguns exemplos de código e os recursos disponíveis.

Observe: O arquivo DOCX produzido pelo IronWord, quando aberto em uma determinada versão do Microsoft Word, pode estar no Modo de Compatibilidade , fazendo com que alguns estilos fiquem indisponíveis. Para converter um documento do Word para fora do modo de compatibilidade

Selecione 'Arquivo' > 'Informações' e clique em "Converter".
Você verá uma mensagem informando que seu documento será atualizado para o formato de arquivo mais recente. Clique em "OK".

Criar documento Word e Docx

Crie o documento Word instanciando a classe WordDocument usando um de seus construtores. Depois disso, use o método SaveAs para exportar o documento Word. Exemplo:

using IronWord;

class Program
{
    static void Main()
    {
        // Create a new Word document
        var document = new WordDocument();

        // Save the document as a .docx file
        document.SaveAs("example.docx");
    }
}

using IronWord;

class Program
{
    static void Main()
    {
        // Create a new Word document
        var document = new WordDocument();

        // Save the document as a .docx file
        document.SaveAs("example.docx");
    }
}

Imports IronWord

Friend Class Program
	Shared Sub Main()
		' Create a new Word document
		Dim document = New WordDocument()

		' Save the document as a .docx file
		document.SaveAs("example.docx")
	End Sub
End Class

Imports IronWord

Friend Class Program
	Shared Sub Main()
		' Create a new Word document
		Dim document = New WordDocument()

		' Save the document as a .docx file
		document.SaveAs("example.docx")
	End Sub
End Class

Adicionar imagem

Não é possível adicionar uma imagem isoladamente; Em vez disso, ele deve ser adicionado a uma das estruturas do documento, como um Paragraph, TableCell ou Section. Use o método AddImage para adicionar uma imagem. Exemplo:

using IronWord;
using System.Drawing;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();

        // Add an image to a paragraph
        var paragraph = section.Paragraphs.Add();
        paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));

        document.SaveAs("example_with_image.docx");
    }
}

using IronWord;
using System.Drawing;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();

        // Add an image to a paragraph
        var paragraph = section.Paragraphs.Add();
        paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));

        document.SaveAs("example_with_image.docx");
    }
}

Imports IronWord
Imports System.Drawing

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()

		' Add an image to a paragraph
		Dim paragraph = section.Paragraphs.Add()
		paragraph.AddImage("path/to/image.jpg", New Rectangle(0, 0, 100, 100))

		document.SaveAs("example_with_image.docx")
	End Sub
End Class

Imports IronWord
Imports System.Drawing

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()

		' Add an image to a paragraph
		Dim paragraph = section.Paragraphs.Add()
		paragraph.AddImage("path/to/image.jpg", New Rectangle(0, 0, 100, 100))

		document.SaveAs("example_with_image.docx")
	End Sub
End Class

Adicionar tabela

Adicionar uma tabela requer a criação da tabela, das linhas, das colunas e das células da tabela. Isso possibilita significativas oportunidades de configuração, já que cada célula pode ter estilos diferentes. Exemplo:

using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // 3x3 table

        // Iterate over cells and set their content
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

        document.SaveAs("example_with_table.docx");
    }
}

using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // 3x3 table

        // Iterate over cells and set their content
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

        document.SaveAs("example_with_table.docx");
    }
}

Imports IronWord

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()
		Dim table = section.Tables.Add(3, 3) ' 3x3 table

		' Iterate over cells and set their content
		For i As Integer = 0 To table.Rows.Count - 1
			Dim j As Integer = 0
			Do While j < table.Rows(i).Cells.Count
				table.Rows(i).Cells(j).Paragraphs.Add().AppendText($"Cell {i+1},{j+1}")
				j += 1
			Loop
		Next i

		document.SaveAs("example_with_table.docx")
	End Sub
End Class

Imports IronWord

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()
		Dim table = section.Tables.Add(3, 3) ' 3x3 table

		' Iterate over cells and set their content
		For i As Integer = 0 To table.Rows.Count - 1
			Dim j As Integer = 0
			Do While j < table.Rows(i).Cells.Count
				table.Rows(i).Cells(j).Paragraphs.Add().AppendText($"Cell {i+1},{j+1}")
				j += 1
			Loop
		Next i

		document.SaveAs("example_with_table.docx")
	End Sub
End Class

Licenciamento e suporte disponíveis

IronWord é uma biblioteca paga; No entanto, licenças de avaliação gratuitas estão disponíveis aqui .

Para obter mais informações sobre a Iron Software, visite nosso site:https://ironsoftware.com/ . Para obter mais suporte e esclarecer dúvidas, entre em contato com nossa equipe .

Suporte da Iron Software

Para suporte geral e dúvidas técnicas, envie um e-mail para:support@ironsoftware.com

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...