Muitas aplicações no ambiente digital de hoje requerem a capacidade de gerar e alterar documentos automaticamente. A capacidade de criar e trabalhar com arquivos DOCX é útil se você está criando um sistema de relatórios de nível empresarial, um sistema de gerenciamento de documentos ou apenas automatizando atividades repetitivas. Neste tutorial, mergulharemos no mundo da geração de documentos C# e examinaremos as robustas bibliotecas e métodos de programação que podem ser usados em C# para criar arquivos DOCX.

How to Create DOCX File in C#

1. Instale o pacote NuGet IronWord.
2. Pegue os namespaces necessários e importe-os do IronWord.
3. Para gerar arquivos de documento, adicione um novo TextRun.
4. Faça um novo Corpo e Documento.
5. Preencha o Corpo com conteúdo (parágrafos, tabelas, etc.).
6. Usando WordDocument, crie um novo WordDocument.
7. Atribuir o objeto Documento à propriedade Document do TextRun, Parágrafo salvará as modificações.

Conhecendo o Formato DOCX

Antes de mergulhar na codificação, vamos esclarecer o que é um arquivo DOCX. Microsoft Word e outros programas de processamento de texto salvam documentos no formato de arquivo DOCX. Baseia-se no padrão XML aberto comprimido por ZIP [Office Open XML (OOXML)](https://en.wikipedia.org/wiki/Office_Open_XML#:~:text=Office%20Open%20XML%20(also%20informally,initial%20version%20as%20ECMA%2D376.). Isso permite utilizar APIs da Microsoft e de outros desenvolvedores para manipulá-lo programaticamente de forma relativamente simples.

IronWord

A Iron Software criou a biblioteca de documentos Word conhecida como IronWord. Quando se trata de oferecer capacidades avançadas para manipulação de documentos Word em aplicativos .NET, IronWord destaca-se. Para ajudar desenvolvedores .NET C# a incluir a capacidade de criar, ler e modificar documentos Word e DOCX em seus programas, IronWord é uma robusta biblioteca de documentos Word.

Recursos do IronWord

• Criar e editar DOC e DOCX: IronWord elimina a necessidade do Office Interop ou instalação do Microsoft Word ao permitir que você crie e edite documentos Word dentro dos seus projetos .NET.
• Abrir, Editar um documento existente e Salvar um arquivo Word e Docx: A estrutura do documento Word é personalizável, incluindo configuração de página (cor de fundo, margens, tamanho do papel e orientação).
• Incluir Palavras e Imagens: Com a API simples, você pode adicionar rapidamente texto e gráficos aos seus documentos Word.
• Suporte Multiplataforma: IronWord é compatível com .NET 8, 7, 6, Core, Standard, ou Framework, e é construído para C#, F# e VB.NET. Ele funciona em vários ambientes, como Docker, iOS, Android, Windows e Linux.
• No mundo inteiro, milhões de engenheiros confiam em nós: IronWord é um componente da Iron Suite, que consiste em nove produtos API de documentos de escritório para .NET. Desenvolvedores de todo o mundo o utilizam para criar, visualizar e modificar documentos Word.

Para saber mais sobre o IronWord, consulte aqui.

Criando um novo projeto no Visual Studio

Para iniciar o aplicativo Visual Studio, use o menu Arquivo e escolha Arquivo. Clique em "Novo Projeto" e depois escolha "Aplicação de console".

Digite o nome do projeto no campo de texto designado após escolher o local do arquivo. Em seguida, como mostrado no exemplo abaixo, clique no botão Criar e escolha o .NET Framework necessário.

A organização do projeto do Visual Studio dependerá então do aplicativo selecionado. Para adicionar código e construir o aplicativo, basta abrir o arquivo program.cs. O aplicativo de internet, Windows ou console pode ser usado.

Após isso, a biblioteca pode ser adicionada e o código testado.

Instalar a biblioteca IronWord

Fazendo Uso da Ferramenta Visual Studio Selecione Gerenciador de Pacotes NuGet no Menu Ferramentas. Entre na interface do Gerenciador de Pacotes para acessar o terminal de gerenciamento de pacotes.

Install-Package IronWord

Após baixar e instalar o pacote, ele já pode ser utilizado no projeto em andamento.

Há também o método do Gerenciador de Pacotes. É possível instalar o pacote diretamente na solução usando a opção Gerenciador de Pacotes NuGet do Visual Studio. Você pode ver como iniciar o Gerenciador de Pacotes NuGet na imagem abaixo.

Utilize a caixa de pesquisa do site NuGet para localizar pacotes. Tudo o que precisamos fazer é pesquisar por "IronWord" no gerenciador de pacotes, como ilustrado na captura de tela abaixo:

A lista de resultados de pesquisa relevantes é exibida na imagem acima. Para instalar o software na sua máquina, basta ajustar estas configurações.

Criar DOCX Usando IronWord

Instancie um objeto WordDocument para iniciar um novo documento Word. Para inicializar o documento, você pode usar qualquer objeto que componha a estrutura do documento, como um parágrafo, tabela ou seção. Aqui está uma ilustração fácil no seguinte trecho de código:

using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

            // Create a new Word document with the paragraph.
            WordDocument doc = new WordDocument(paragraph);

            // Export and save the DOCX file to the specified path.
            doc.SaveAs("document.docx");
        }
    }
}

using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

            // Create a new Word document with the paragraph.
            WordDocument doc = new WordDocument(paragraph);

            // Export and save the DOCX file to the specified path.
            doc.SaveAs("document.docx");
        }
    }
}

Imports IronWord
Imports IronWord.Models

Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run, which is a portion of the document's text content.
			Dim textRun As New TextRun("Hello, IronWord!")

			' Create a paragraph and add the text run to it.
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)

			' Create a new Word document with the paragraph.
			Dim doc As New WordDocument(paragraph)

			' Export and save the DOCX file to the specified path.
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace

Imports IronWord
Imports IronWord.Models

Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run, which is a portion of the document's text content.
			Dim textRun As New TextRun("Hello, IronWord!")

			' Create a paragraph and add the text run to it.
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)

			' Create a new Word document with the paragraph.
			Dim doc As New WordDocument(paragraph)

			' Export and save the DOCX file to the specified path.
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace

Podemos adicionar texto ao documento com a ajuda da classe TextRun, que nos permite passar o texto para o objeto parágrafo com a ajuda do método AddTextRun. Em seguida, estamos criando um novo objeto WordDocument para criar um novo arquivo DOCX. Então, usando o método SaveAs, podemos salvar o novo documento DOCX no local desejado. Abaixo está o resultado gerado pelo código acima.

Para saber mais sobre o código IronWord, consulte aqui.

Conclusão

Nós analisamos como usar C# para gerar um arquivo de documento DOCX neste guia. Os fundamentos do formato DOCX foram discutidos, juntamente com o Open XML SDK e a biblioteca DocX, e foram dados exemplos de como usá-los para gerar, editar e salvar arquivos DOCX.

Todas essas ferramentas e métodos o colocarão em uma posição forte para lidar com uma variedade de tarefas de criação de documentos em seus projetos C#. Aprender a produção de documentos em C# é uma habilidade útil que o ajudará em várias situações, seja automatizando a geração de relatórios, desenvolvendo sistemas de gerenciamento de documentos ou apenas criando modelos para usuários finais.

Para desenvolvedores que trabalham com .NET C#, IronWord é uma biblioteca de documentos Word poderosa e adaptável. Ele permite que os desenvolvedores leiam, escrevam e editem documentos Word (DOCX) em seus aplicativos com facilidade. A API amigável do IronWord simplifica o processamento de documentos Word. Sem exigir que o Microsoft Word esteja instalado ou depender do Office Interop, os desenvolvedores podem criar e editar arquivos do Word diretamente dentro de seus projetos .NET. Adicionar texto, parágrafos e outros elementos a novos documentos do Word é facilitado.

IronWord é $999 quando é lançado pela primeira vez. Além disso, os clientes que pagam uma taxa de assinatura anual podem receber assistência e atualizações sobre produtos. Por uma taxa, o IronWord oferece uma defesa contra redistribuição desenfreada. Para saber mais sobre o custo aproximado, visite esta página. Veja mais sobre a Iron Software clicando neste link.