A .NET Word API fornece aos desenvolvedores ferramentas robustas para converter documentos Word e interagir com, e manipular documentos MS Word em suas aplicações. Esta API é projetada para simplificar o processo de trabalho com documentos do Microsoft Word, tornando mais fácil criar, editar, converter e gerenciar documentos programaticamente. Neste artigo, exploraremos o IronWord para entender suas capacidades na manipulação de documentos Word.

Introdução ao IronWord

IronWord é uma biblioteca Word .NET dentro do ecossistema .NET Word API, projetada especificamente para desenvolvedores que processam documentos do Microsoft Word em suas aplicações .NET. Com o IronWord, os desenvolvedores podem facilmente ler, escrever e modificar documentos Word sem precisar do Microsoft Word instalado nos servidores ou máquinas clientes. Essa capacidade é particularmente benéfica para aplicações que precisam automatizar tarefas de processamento de documentos, como gerar relatórios, faturas ou correspondência personalizada através de funcionalidades de mala direta.

Características do IronWord

O IronWord oferece uma gama abrangente de recursos que atendem a vários aspectos da manipulação de documentos Word. Vamos explorar cada conjunto de recursos, focando em como eles permitem a manipulação e mesclagem de múltiplos documentos, categorizados sob 'Estrutura do Documento' e 'Elementos do Documento'.

Estrutura do Documento

Ler e Editar Word: Com o IronWord, você pode extrair informações específicas de seus documentos Word, como extrair texto para edição ou reutilização e recuperar imagens que possam precisar ser usadas em outro lugar. Essa capacidade é vital para aplicações que visam unir documentos Word e processar as informações contidas em arquivos DOCX existentes.

Múltiplos Formatos: O IronWord suporta uma ampla gama de formatos de arquivo, aumentando sua utilidade na conversão de documentos Word em aplicações .NET.

Editar Configuração de Página: Personalizar o layout físico de seus documentos Word é simples com o IronWord. Você pode ajustar o tamanho do papel para vários arquivos MS Word para dimensões padrão ou personalizadas, mudar a orientação para diferentes seções de seu documento, definir as margens para garantir um alinhamento adequado e até mesmo modificar a cor de fundo para fins estéticos ou para destacar seções.

Adicionar Parágrafos: O IronWord permite a adição e remoção de execuções de texto dentro dos parágrafos, o que é essencial para editar e formatar grandes seções de texto. Além disso, você pode aprimorar seus parágrafos inserindo imagens e formas diretamente no texto, ajustando o estilo para corresponder às suas especificações de design, e definindo alinhamentos para um visual refinado. A capacidade de adicionar listas com marcadores e numerações também ajuda a organizar o conteúdo de forma mais eficaz.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();
        
        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
        
        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
        
        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
        
        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();
        
        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
        
        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
        
        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
        
        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Load docx
        Dim doc As New WordDocument()
        ' Create and add styled text to a paragraph
        Dim paragraph As New Paragraph()
        
        ' Adding regular text
        paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
        
        ' Adding italic text
        paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
        
        ' Adding bold text
        paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
        
        ' Add paragraph to the document and export docx
        doc.AddParagraph(paragraph)
        doc.SaveAs("newdocument.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Load docx
        Dim doc As New WordDocument()
        ' Create and add styled text to a paragraph
        Dim paragraph As New Paragraph()
        
        ' Adding regular text
        paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
        
        ' Adding italic text
        paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
        
        ' Adding bold text
        paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
        
        ' Add paragraph to the document and export docx
        doc.AddParagraph(paragraph)
        doc.SaveAs("newdocument.docx")
    End Sub
End Module

Adicionar Tabelas: Tabelas são um componente crítico dos arquivos DOCX e são facilmente manipuladas com o IronWord, apoiando a geração dinâmica de documentos. Você pode adicionar ou remover linhas e colunas, uma operação que é fundamental para a geração dinâmica de documentos onde a quantidade de dados pode variar. Juntar e dividir células dá a você a versatilidade de formatar tabelas complexas, e personalizar bordas e dimensões de layout permite uma aparência refinada e profissional.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
        
        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };
        
        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };
        
        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);
        
        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
        
        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };
        
        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };
        
        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);
        
        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a table cell with a paragraph containing text
        Dim cell As New TableCell(New Paragraph(New TextRun("Sample text")))

        ' Configure a common border style for the table
        Dim borderStyle As New BorderStyle With {
            .BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
            .BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            .BorderSize = 5
        }

        ' Apply the border style to the cell
        cell.Borders = New TableBorders With {
            .TopBorder = borderStyle,
            .RightBorder = borderStyle,
            .BottomBorder = borderStyle,
            .LeftBorder = borderStyle
        }

        ' Create a table row and add the same cell twice
        Dim row As New TableRow()
        row.AddCell(cell)
        row.AddCell(cell)

        ' Create a table, add the row, then create and export the Word document
        Dim table As New Table()
        table.AddRow(row)
        Dim doc As New WordDocument(table)
        doc.SaveAs("Document.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a table cell with a paragraph containing text
        Dim cell As New TableCell(New Paragraph(New TextRun("Sample text")))

        ' Configure a common border style for the table
        Dim borderStyle As New BorderStyle With {
            .BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
            .BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            .BorderSize = 5
        }

        ' Apply the border style to the cell
        cell.Borders = New TableBorders With {
            .TopBorder = borderStyle,
            .RightBorder = borderStyle,
            .BottomBorder = borderStyle,
            .LeftBorder = borderStyle
        }

        ' Create a table row and add the same cell twice
        Dim row As New TableRow()
        row.AddCell(cell)
        row.AddCell(cell)

        ' Create a table, add the row, then create and export the Word document
        Dim table As New Table()
        table.AddRow(row)
        Dim doc As New WordDocument(table)
        doc.SaveAs("Document.docx")
    End Sub
End Module

.NET API Word (Como Funciona para Desenvolvedores): Figura 1 - PDF gerado com uma tabela

Elementos do Documento

Adicionar Execuções de Texto: Este recurso foca no controle preciso sobre o conteúdo do texto. Você pode adicionar, anexar e dividir execuções de texto, o que é vital para a criação dinâmica de documentos. As opções de estilo são extensas, incluindo a alteração de famílias de fontes, tamanhos e cores, além de adicionar negrito, itálico e outras decorações de texto. Você também pode incorporar imagens dentro das execuções de texto, criando um documento rico e visualmente atraente.

Adicionar Imagens: IronWord permite uma manipulação abrangente de imagens em Documentos Word. Você pode carregar imagens de várias fontes, ajustar o texto ao redor delas perfeitamente, e ajustar suas dimensões para caber no seu layout. A capacidade de definir o deslocamento de posição e a distância dos cantos do documento garante que suas imagens estarão sempre perfeitamente posicionadas.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();
        
        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };
        
        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);
        
        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();
        
        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };
        
        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);
        
        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        Dim doc As New WordDocument()
        
        ' Load and configure the image
        Dim image As New IronWord.Models.Image("your-image.jpg") With {
            .Width = 200, ' In unit pixels
            .Height = 200 ' In unit pixels
        }
        
        ' Create paragraph, add image, add paragraph to document, and export
        Dim paragraph As New Paragraph()
        paragraph.AddImage(image)
        
        ' Add paragraph containing the image to the document
        doc.AddParagraph(paragraph)
        doc.SaveAs("save_document.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        Dim doc As New WordDocument()
        
        ' Load and configure the image
        Dim image As New IronWord.Models.Image("your-image.jpg") With {
            .Width = 200, ' In unit pixels
            .Height = 200 ' In unit pixels
        }
        
        ' Create paragraph, add image, add paragraph to document, and export
        Dim paragraph As New Paragraph()
        paragraph.AddImage(image)
        
        ' Add paragraph containing the image to the document
        doc.AddParagraph(paragraph)
        doc.SaveAs("save_document.docx")
    End Sub
End Module

Adicionar Formas: As formas podem adicionar um impacto visual significativo a um documento, e IronWord oferece as ferramentas para inseri-las e personalizá-las com precisão. Você pode definir o tipo de forma (como retângulos, círculos, setas, etc.), determinar como o texto deve se ajustar em torno da forma, especificar dimensões e posicionamento exatos, e até mesmo girar formas para alcançar o efeito visual desejado.

Compatibilidade

Versões .NET & Tipos de Projetos

.NET API Word (Como Funciona para Desenvolvedores): Figura 2 - As versões do .NET e tipos de projeto que IronWord é compatível

IronWord é projetado para ampla compatibilidade dentro do ecossistema .NET, suportando C#, VB.NET e F# em várias versões do .NET, incluindo .NET Core, .NET Standard e .NET Framework. Isso garante sua utilidade em aplicações contemporâneas e legadas. A versatilidade da biblioteca se estende a tipos de projeto, acomodando aplicativos web, móveis e de desktop através da integração com Blazor, WebForms, Xamarin, MAUI, WPF e aplicativos de console.

Ambientes de aplicativos

.NET API Word (Como Funciona para Desenvolvedores): Figura 3 - Os ambientes de aplicativo onde IronWord pode funcionar

Em termos de ambientes de aplicação, IronWord é adaptável às plataformas Windows, Linux, iOS, e Android, incluindo suporte específico para conteinerização e implantação na nuvem no Docker, Azure, e AWS. Este suporte abrangente facilita o desenvolvimento em diferentes ambientes.

Sistemas Operacionais & IDEs

.NET API Word (Como Funciona para Desenvolvedores): Figura 4 - Os sistemas operacionais e IDEs que IronWord é compatível

IronWord também é compatível com os principais Ambientes de Desenvolvimento Integrado (IDEs), como Microsoft Visual Studio, ReSharper e Rider, oferecendo aos desenvolvedores flexibilidade na escolha de suas ferramentas. Por último, oferece suporte a vários sistemas operacionais e arquiteturas de processador (x64, x86, ARM), garantindo desempenho eficiente em diversas configurações de hardware.

Opções de Licenciamento

.NET API Word (Como Funciona para Desenvolvedores): Figura 5 - Página de licenciamento do IronWord

IronWord oferece várias opções de licenciamento para acomodar as necessidades de diferentes desenvolvedores e organizações. Eles oferecem uma licença perpétua, o que significa que você paga uma vez e não há taxas recorrentes. Cada licença inclui um ano de suporte ao produto e atualizações. Os níveis de licenciamento são projetados com base no número de desenvolvedores, locais e projetos que você tem. Você também pode obter uma versão de teste gratuita para ter uma experiência prática antes de comprar uma licença.

Licença Lite

Esta opção é adaptada para desenvolvedores individuais trabalhando sozinhos em um projeto. Ele custa $999 e cobre um desenvolvedor em um único local.

Licença Plus

Destinada a pequenas equipes, esta licença, por $1,499, acomoda até três desenvolvedores e é aplicável para uso em três locais em três projetos.

Licença Professional

Para equipes maiores, a Licença Professional é precificada em $2,399 e suporta até dez desenvolvedores. Ela é projetada para atender operações mais substanciais e inclui recursos de suporte premium.

Conclusão

Para encerrar, IronWord surge como uma API .NET Word robusta e flexível, oferecendo uma gama de opções de licenciamento para atender às diversas necessidades de desenvolvedores individuais e equipes. Seus recursos permitem gerenciamento e manipulação eficientes de documentos Word, garantindo compatibilidade com várias versões .NET e tipos de projeto.