API do Word for .NET (Como funciona para desenvolvedores)

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

Friend Class Program
	Shared 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 Class

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

Friend Class Program
	Shared 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 Class

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

Friend Class Program
	Shared 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,
			.Height = 200
		}

		' 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 Class

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.

Versões .NET & Tipos de Projetos

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

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

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.

Licença Lite

Esta opção é adaptada para desenvolvedores individuais trabalhando sozinhos em um projeto. O preço é $799 e cobre um desenvolvedor em uma única localização.

Licença Plus

Destinada a pequenas equipes, esta licença, por $plusLicense, 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 $professionalLicense e suporta até dez desenvolvedores. Ela é projetada para atender operações mais substanciais e inclui recursos de suporte premium.