Ir para o conteúdo do rodapé
USANDO IRONWORD

Como criar um arquivo DOCX em C#

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

Como Criar Arquivo DOCX em C#: Figura 1 - Criando um novo projeto

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.

Como Criar Arquivo DOCX em C#: Figura 2 - Configurando o nome do projeto e o caminho do arquivo

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.

Como Criar Arquivo DOCX em C#: Figura 3 - Instalando IronWord com o console do gerenciador de pacotes

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.

Como Criar Arquivo DOCX em C#: Figura 4 - Como encontrar o gerenciador de pacotes NuGet

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:

Como Criar Arquivo DOCX em C#: Figura 5 - Instalando IronWord com o gerenciador de pacotes NuGet

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

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

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. Depois, estamos criando um novo objeto WordDocument para criar um novo arquivo DOCX. Em seguida, usando o método SaveAs, podemos salvar o novo documento DOCX na localização desejada. Abaixo está o resultado gerado pelo código acima.

Como Criar Arquivo DOCX em C#: Figura 6 - PDF gerado a partir do código anterior

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 é $799 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.

Perguntas frequentes

Como posso gerar um arquivo DOCX usando C#?

Para gerar um arquivo DOCX usando C#, você pode utilizar a biblioteca IronWord. Comece instalando o pacote NuGet IronWord, importe os namespaces necessários e crie um objeto WordDocument . Em seguida, você pode adicionar conteúdo usando métodos como AddTextRun e salvar o documento com o método SaveAs .

Quais são os benefícios de usar o IronWord para gerar arquivos DOCX?

O IronWord oferece diversas vantagens para a geração de arquivos DOCX, incluindo a capacidade de criar e editar documentos sem o Microsoft Word, suporte multiplataforma e uma API amigável que simplifica o processo de criação de documentos.

Posso adicionar imagens a um arquivo DOCX usando o IronWord?

Sim, o IronWord permite adicionar imagens a um arquivo DOCX. Você pode usar o método AddImage para incorporar imagens ao seu documento, o que pode melhorar o apelo visual e a funcionalidade dos seus arquivos DOCX.

É possível editar arquivos DOCX existentes com o IronWord?

Sim, o IronWord permite editar arquivos DOCX existentes. Você pode abrir um arquivo DOCX usando o IronWord, modificar seu conteúdo, estrutura ou formatação e, em seguida, salvar as alterações.

O IronWord suporta a geração de documentos no Linux?

Sim, o IronWord suporta a geração de documentos no Linux como parte de seus recursos multiplataforma, permitindo que os desenvolvedores criem e manipulem arquivos DOCX em diversos sistemas operacionais, incluindo o Linux.

Quais são os passos envolvidos na configuração do IronWord em um projeto C#?

A configuração do IronWord em um projeto C# envolve a instalação do pacote NuGet do IronWord através do Gerenciador de Pacotes NuGet, a importação dos namespaces necessários para o seu código e a utilização da API do IronWord para realizar tarefas de criação e edição de documentos.

Como o IronWord lida com a compatibilidade de arquivos DOCX?

O IronWord foi projetado para ser compatível com o formato DOCX, garantindo que arquivos criados ou editados com o IronWord possam ser abertos e usados no Microsoft Word e em outros processadores de texto compatíveis.

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

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me