Primeiros passos com o IronWord

This article was translated from English: Does it need improvement?
Translated
View the article in English

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: Configurando o tamanho do papel, orientação da página, margens e cor de fundo.
  • TextRun: Manipulando conteúdo de texto, estilos, dividindo, anexando texto e adicionando imagens.
  • TextStyle: Gerenciando família de fontes, tamanho, cor, negrito, itálico, tachado, sublinhado, sobrescrito e subscrito.
  • Paragraph: Adicionando trechos de texto, imagens, formas, definindo estilos, alinhamentos, marcadores e listas numeradas.
  • Table: Manipulando a estrutura da tabela, incluindo a adição de linhas, obtendo e definindo valores de célula, removendo linhas, mesclando células e mais.
  • Image: Carregando imagens de arquivos ou fluxos, definindo quebra de texto, deslocamento de posição, largura, altura e outras propriedades.
  • Shape: Definindo quebra de texto, deslocamento de posição, largura, altura, tipo de forma e rotação.

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:

Install-Package IronWord

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

Depois de 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";
$vbLabelText   $csharpLabel

Exemplos de código

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

ObserveO 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

  1. Selecione 'Arquivo' > 'Informações' e clique em "Converter".
  2. 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");
    }
}
$vbLabelText   $csharpLabel

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");
    }
}
$vbLabelText   $csharpLabel

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");
    }
}
$vbLabelText   $csharpLabel

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

Leia mais
Pronto para começar?
Nuget Downloads 35,581 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronWord
executar um exemplo Veja seus dados se transformarem em um documento do Word.