VS 2022: Criar novos documentos do Word programaticamente (Tutorial)
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";' 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
Explicação
- Primeiro, importamos a Biblioteca IronWord e seus modelos no código de exemplo.
- Nós criamos uma nova variável
Text. Esta variável nos permite adicionar texto ao documento Word. - Em seguida, adicionamos o
textRuna umParagraph. Isso nos permite manipular facilmente o texto, distinguindo entre os dois. - Nós passamos o parâmetro
paragraphpara uma nova classeWordDocumentpara criar um novo objeto de documento. - 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
Explicação do código
- Como no exemplo acima, criamos o objeto
Texte adicionamos o texto de exemplo para o documento. - Em seguida, criamos um novo objeto
TextStylee atribuímos a propriedadeIsItaliccomotrue, indicando que o texto deve estar em itálico. - Fazemos o mesmo para a variável
boldText, atribuindotrueà propriedadeIsBold. - Em seguida, atribuímos as variáveis
TextStyleàs respectivas variáveisText. - Criamos uma variável
Paragraphe chamamos o métodoAddTextpara adicionar o texto em itálico e negrito. - Adicionamos o parágrafo ao documento usando o método
AddParagraph. - 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.
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 .
Comece GRATUITAMENTE
Comece GRATUITAMENTE
Agende uma demonstração ao vivo gratuita
Não é necessário cartão de crédito nem criação de conta.
