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 Word C#

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 para .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 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";

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

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");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a textrun
		Dim textRun As New Text("Sample text")
		Dim paragraph As New Paragraph()
		paragraph.AddChild(textRun)

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

		' Export docx
		doc.SaveAs("document.docx")
	End Sub
End Class

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a textrun
		Dim textRun As New Text("Sample text")
		Dim paragraph As New Paragraph()
		paragraph.AddChild(textRun)

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

		' Export docx
		doc.SaveAs("document.docx")
	End Sub
End Class

Explicação

1. Primeiro, importamos a Biblioteca IronWord e seus modelos no código de exemplo.
2. 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. 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");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Ensure to set up the license key
		IronWord.License.LicenseKey = "YOUR-KEY"

		' Load an existing docx
		Dim doc As New WordDocument("document.docx")

		' Create sample texts with styles
		Dim introText As New Text("This is an example paragraph with italic and bold styling.")
		Dim italicStyle As New TextStyle() With {.IsItalic = True}
		Dim italicText As New Text("Italic example sentence.")
		italicText.Style = italicStyle

		Dim boldStyle As New TextStyle() With {.IsBold = True}
		Dim boldText As New Text("Bold example sentence.")
		boldText.Style = boldStyle

		' Create a paragraph and add texts
		Dim paragraph As 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")
	End Sub
End Class

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Ensure to set up the license key
		IronWord.License.LicenseKey = "YOUR-KEY"

		' Load an existing docx
		Dim doc As New WordDocument("document.docx")

		' Create sample texts with styles
		Dim introText As New Text("This is an example paragraph with italic and bold styling.")
		Dim italicStyle As New TextStyle() With {.IsItalic = True}
		Dim italicText As New Text("Italic example sentence.")
		italicText.Style = italicStyle

		Dim boldStyle As New TextStyle() With {.IsBold = True}
		Dim boldText As New Text("Bold example sentence.")
		boldText.Style = boldStyle

		' Create a paragraph and add texts
		Dim paragraph As 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")
	End Sub
End Class

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 suas 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

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.