Ícone de mensagem
Ir para o conteúdo do rodapé
  1. IronWord
  2. Blog IronWord
  3. Usando IronWord
  4. VS 2022: Criar novos documentos do Word programaticamente
USANDO IRONWORD

VS 2022: Criar novos documentos do Word programaticamente (Tutorial)

Curtis Chau
Curtis Chau
Atualizado:

Documentos estão se tornando cada vez mais digitais na era digital. Documentos no ambiente empresarial são frequentemente associados ao Microsoft Word e seu arquivo baseado em documento Word. Escrever e editar documentos Microsoft Word se tornou a base para a circulação de informações em grandes organizações. No entanto, criar e editar documentos manualmente pode ser um processo doloroso; automatizar a geração de Word programaticamente também não é uma tarefa fácil, pois muitas bibliotecas de código aberto dependem do Microsoft Office Word como dependência.

No entanto, gerenciar e criar documentos Word não precisa ser tão difícil. IronWord é uma biblioteca de C# para documentos Word que não depende do Microsoft Office Word e permite aos usuários personalizar o documento inteiro, além de permitir a geração de documentos e a criação de modelos de documentos de forma programática.

Neste tutorial, explicarei brevemente como criar um documento do Microsoft Word programaticamente usando o IronWord e fornecerei alguns exemplos.

IronWord: Uma Biblioteca de C# para Word

IronWord é uma biblioteca C# Docx excepcionalmente confiável e fácil de usar, que capacita os desenvolvedores a construir e modificar documentos Word usando C#, tudo isso sem precisar de dependências tradicionais como Microsoft Office ou Word Interop. Além disso, possui documentação extensa e oferece suporte completo for .NET 8, 7, 6, Framework, Core e Azure, tornando-o universalmente compatível com a maioria das aplicações. Esse nível de flexibilidade o torna uma excelente escolha para qualquer aplicação com que você possa estar lidando.

Configurando o ambiente

Para este exemplo, criaremos um aplicativo de console usando Visual Studio e mostraremos como criar documentos Word em branco e manipulá-los usando a Biblioteca IronWord. Antes de prosseguirmos com este próximo passo, certifique-se de ter o Visual Studio instalado.

Primeiro, vamos criar um novo aplicativo de console.

Em seguida, forneça um nome para o projeto e salve a localização, conforme mostrado abaixo.

Finalmente, selecione o framework desejado.

Instalando a Biblioteca de Word para C

Após criar o aplicativo de console em branco, faremos o download do IronWord através do Gerenciador de Pacotes NuGet.

Clique em "Gerenciar Pacotes NuGet", depois procure por IronWord na aba "Procurar", conforme mostrado abaixo.

Depois, instale-o no projeto recém-criado.

Alternativamente, você pode digitar o seguinte comando na linha de comando para instalar o IronWord.

Install-Package IronWord

Agora que tudo está configurado e pronto para começar, vamos passar para um exemplo de criação de documentos Word.

Chave de licença

Lembre-se de que o IronWord requer uma chave de licença para operação. Você pode obter uma chave como parte de um teste gratuito visitando este link .

// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";
// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";
$vbLabelText   $csharpLabel

Após receber uma chave de teste, defina esta variável em seu projeto.

Criando um novo Documento Word

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

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

        // Export docx
        doc.SaveAs("document.docx");
    }
}
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

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

        // Export docx
        doc.SaveAs("document.docx");
    }
}
$vbLabelText   $csharpLabel

VS 2022 Criação Programática de Novos Documentos Word (Tutorial): Figura 6 - Saída do exemplo acima

Explicação

  1. Primeiro, importamos a Biblioteca IronWord e seus modelos no código de exemplo.
  2. Nós criamos uma nova variável Text. Esta variável nos permite adicionar texto ao documento Word.
  3. Em seguida, adicionamos o textRun a um Paragraph. Isso nos permite manipular facilmente o texto, distinguindo entre os dois.
  4. Nós passamos o parâmetro paragraph para uma nova classe WordDocument para criar um novo objeto de documento.
  5. Finalmente, salvamos o documento como "document.docx" em um arquivo Word.

No exemplo anterior, criamos um documento Word com texto básico. Vamos fazer um exemplo com recursos mais avançados, como personalizar o texto e adicionar efeitos de texto.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

        // Load an existing docx
        WordDocument doc = new WordDocument("document.docx");

        // Create sample texts with styles
        Text introText = new Text("This is an example paragraph with italic and bold styling.");
        TextStyle italicStyle = new TextStyle()
        {
            IsItalic = true
        };
        Text italicText = new Text("Italic example sentence.");
        italicText.Style = italicStyle;

        TextStyle boldStyle = new TextStyle()
        {
            IsBold = true
        };
        Text boldText = new Text("Bold example sentence.");
        boldText.Style = boldStyle;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

        // Load an existing docx
        WordDocument doc = new WordDocument("document.docx");

        // Create sample texts with styles
        Text introText = new Text("This is an example paragraph with italic and bold styling.");
        TextStyle italicStyle = new TextStyle()
        {
            IsItalic = true
        };
        Text italicText = new Text("Italic example sentence.");
        italicText.Style = italicStyle;

        TextStyle boldStyle = new TextStyle()
        {
            IsBold = true
        };
        Text boldText = new Text("Bold example sentence.");
        boldText.Style = boldStyle;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}
$vbLabelText   $csharpLabel

VS 2022 Criação Programática de Novos Documentos Word (Tutorial): Figura 7 - Saída do código de exemplo acima

Explicação do código

  1. Como no exemplo acima, criamos o objeto Text e adicionamos o texto de exemplo para o documento.
  2. Em seguida, criamos um novo objeto TextStyle e atribuímos a propriedade IsItalic como true, indicando que o texto deve estar em itálico.
  3. Fazemos o mesmo para a variável boldText, atribuindo true à propriedade IsBold.
  4. Em seguida, atribuímos as variáveis TextStyle às respectivas variáveis Text.
  5. Criamos uma variável Paragraph e chamamos o método AddText para adicionar o texto em itálico e negrito.
  6. Adicionamos o parágrafo ao documento usando o método AddParagraph.
  7. Finalmente, salvamos o documento como "save_document.docx".

O exemplo acima demonstra as fontes e estilos que os desenvolvedores podem usar com IronWord. Além dos efeitos de texto em itálico e negrito, o IronWord também oferece outros recursos para garantir que os desenvolvedores tenham todas as opções para criar documentos Word únicos em vários cenários.

Conclusão

VS 2022 Criação Programática de Novos Documentos Word (Tutorial): Figura 8 - informações de licenciamento do IronWord

Nossas demonstrações mostraram como é fácil usar a biblioteca IronWord para criar documentos Word programaticamente em C#. A flexibilidade e escalabilidade da biblioteca fazem dela uma ferramenta valiosa para desenvolvedores em cenários da vida real, como personalização de texto, fonte e estilo em um documento Word. Compreender como o Word se integra com outras aplicações fornece aos desenvolvedores soluções adicionais para seus desafios.

O IronWord oferece uma licença de avaliação gratuita.

Perguntas frequentes

Como posso criar um documento do Microsoft Word programaticamente em C#?

É possível criar um documento do Microsoft Word programaticamente em C# usando a biblioteca IronWord. Inicialize um objeto WordDocument , adicione o conteúdo necessário e use o método SaveAs para exportá-lo como um arquivo .docx.

Quais são as vantagens de usar o IronWord em vez do Microsoft Office Interop para a criação de documentos do Word?

O IronWord oferece vantagens em relação ao Microsoft Office Interop por não exigir a instalação do Microsoft Office, proporcionando maior flexibilidade e integração mais fácil em diferentes plataformas, sem depender do Office.

Como instalo o IronWord no Visual Studio?

Para instalar o IronWord no Visual Studio, abra o Gerenciador de Pacotes NuGet, procure por IronWord e instale-o em seu projeto. Como alternativa, use a linha de comando com Install-Package IronWord .

Posso formatar texto em um documento do Word usando o IronWord?

Sim, você pode formatar texto em um documento do Word usando o IronWord, utilizando o objeto TextStyle para aplicar vários estilos, como itálico e negrito, aos elementos de texto.

O IronWord é compatível com .NET e Azure?

Sim, o IronWord é totalmente compatível com .NET 8, 7, 6, Framework, Core e Azure, o que o torna versátil para diversas aplicações.

Como posso solucionar problemas de instalação do IronWord?

Se você encontrar problemas de instalação com o IronWord, certifique-se de estar usando uma versão compatível do Visual Studio e do .NET e de que seu Gerenciador de Pacotes NuGet esteja atualizado. Verifique sua conexão com a internet e tente a instalação novamente.

O que é necessário para começar a criar documentos do Word com o IronWord?

Para começar a criar documentos do Word com o IronWord, importe a biblioteca IronWord e seus modelos para o seu projeto C#. Em seguida, inicialize um objeto WordDocument para começar a construir seu documento.

Como posso adicionar parágrafos a um documento do Word programaticamente usando o IronWord?

É possível adicionar parágrafos a um documento do Word programaticamente usando o IronWord, criando objetos Paragraph , adicionando texto a eles e incluindo-os no WordDocument .

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
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

Artigos relacionados

Teste grátis por 30 dias → Produto completo. Sem limites. Sem cartão. Comece seu teste gratuito

Iron Support Team

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