Crear nuevos documentos de Word programáticamente en VS 2022 (Tutorial)

Los documentos se están volviendo cada vez más digitales en la era digital. Los documentos en el entorno empresarial a menudo se asocian con Microsoft Word y su archivo de Word basado en documentos. Escribir y editarMicrosoft WordLos documentos se han convertido en la base para transmitir información en grandes organizaciones. Sin embargo, crear y editar documentos manualmente puede ser un proceso tedioso; automatizar la generación de Word mediante programación tampoco es una tarea fácil, ya que muchas bibliotecas de código abierto dependen de Microsoft Office Word como dependencia.

Sin embargo, administrar y crear documentos de Word no necesita ser tan difícil. IronWordes una biblioteca de Word de C# que no depende de Microsoft Office Word y permite a los usuarios personalizar todo el documento, además de permitir la generación de documentos y la creación de plantillas de documentos mediante programación.

En el tutorial de hoy, explicaré brevemente cómo crear un Documento de Microsoft Word de forma programática utilizando IronWord y proporcionaré breves ejemplos.

IronWord: Una biblioteca de Word para C#

Imagen rota Añadir desde Pixabay, seleccionar de tus archivos o arrastrar y soltar una imagen aquí.

IronWord es una biblioteca C# Docx excepcionalmente confiable y fácil de usar que permite a los desarrolladores construir y modificar documentos de Word usando C, todo sin necesitar dependencias tradicionales como Microsoft Office o Word Interlope. Además, cuenta con una extensa documentación y ofrece soporte completo para .NET 8, 7, 6, Framework, Core y Azure, lo que lo hace universalmente compatible con la mayoría de las aplicaciones. Este nivel de flexibilidad lo convierte en una excelente opción para cualquier aplicación con la que pueda estar trabajando.

Configuración del entorno

Para este ejemplo, crearemos una aplicación de consola usando Visual Studioy mostrar cómo crear documentos de Word en blanco y manipularlos utilizando la biblioteca IronWord. Antes de proceder con este siguiente paso, asegúrese de tener instalado Visual Studio.

Primero, creemos una nueva aplicación de consola.

Imagen rota Añadir desde Pixabay, seleccionar de tus archivos o arrastrar y soltar una imagen aquí.

Luego, proporcione un nombre para el proyecto y guarde la ubicación, como se muestra a continuación.

Imagen rota Añadir desde Pixabay, seleccionar de tus archivos o arrastrar y soltar una imagen aquí.

Finalmente, seleccione el framework deseado.

Imagen rota Añadir desde Pixabay, seleccionar de tus archivos o arrastrar y soltar una imagen aquí.

Instalación de la Biblioteca Word para C

Después de crear la aplicación de consola en blanco, descargaremos IronWorda través del Administrador de Paquetes NuGet.

Haga clic en "Administrar paquetes NuGet", luego busque IronWord en la "Pestaña de exploración" como se muestra a continuación.

Imagen rota Añadir desde Pixabay, seleccionar de tus archivos o arrastrar y soltar una imagen aquí.

Después, instálalo en el proyecto recién creado.

Alternativamente, puede escribir el siguiente comando en la línea de comandos para instalar IronWord.

Install-Package IronWord

Install-Package IronWord

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronWord

Ahora que todo está configurado y listo para comenzar, pasemos a un ejemplo de creación de documentos Word.

Clave de licencia

Recuerde que IronWord requiere una clave de licencia para su funcionamiento. Puede obtener una clave como parte de una prueba gratuita visitando este enlaceenlace.

//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";

IRON VB CONVERTER ERROR developers@ironsoftware.com

Tras recibir una clave de prueba, establezca esta variable en su proyecto.

Creando un nuevo Documento de Word

using IronWord;
using IronWord.Models;
// Create textrun
Text textRun = new Text("Sample text");
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new Word document
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");

using IronWord;
using IronWord.Models;
// Create textrun
Text textRun = new Text("Sample text");
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new Word document
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");

Imports IronWord
Imports IronWord.Models
' Create textrun
Private textRun As New Text("Sample text")
Private paragraph As New Paragraph()
paragraph.AddChild(textRun)
' Create a new Word document
Dim doc As New WordDocument(paragraph)
' Export docx
doc.SaveAs("document.docx")

Explicación

1. Primero, importamos la biblioteca IronWord y sus modelos en el código de ejemplo.

2. A continuación, creamos una nueva variable "Text". Esta variable nos permite agregar texto al documento de Word.

3. A continuación, añadimos el "texto" a un "Párrafo". Esto nos permite manipular fácilmente el texto distinguiendo entre los dos.

4. Luego pasamos el parámetro "paragraph" a una nueva clase "WordDocument" para crear un nuevo objeto de documento.

5. Finalmente, guardamos el documento como "document.docx" en un archivo de Word.

   En el ejemplo anterior, creamos un documento de Word con texto básico. Hagamos un ejemplo con características más avanzadas, como personalizar el texto y agregar efectos de texto.

using IronWord;
using IronWord.Models;
#region
IronWord.License.LicenseKey = "YOUR-KEY";
#endregion
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
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;
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddText(introText);
paragraph.AddText(italicText);
paragraph.AddText(boldText);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");

using IronWord;
using IronWord.Models;
#region
IronWord.License.LicenseKey = "YOUR-KEY";
#endregion
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
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;
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddText(introText);
paragraph.AddText(italicText);
paragraph.AddText(boldText);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
#Region ""
IronWord.License.LicenseKey = "YOUR-KEY"
'#End Region
' Load docx
Dim doc As New WordDocument("document.docx")
' Configure text
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
Dim paragraph As New Paragraph()
' Add text
paragraph.AddText(introText)
paragraph.AddText(italicText)
paragraph.AddText(boldText)
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("save_document.docx")

Explicación del código

1. Como en el ejemplo anterior, creamos el objeto "Text" y agregamos el texto de muestra para el documento.

2. Luego, creamos un nuevo objeto "TextStyle" y asignamos la propiedad "IsItalic" como verdadera, indicando que el texto debe estar en cursiva.

3. También lo hacemos para la variable "boldText", asignando verdadero a la propiedad "IsBold".

4. A continuación, asignamos las variables "TextStyle" a su respectiva variable "Text".

5. Luego creamos una variable "Paragraph" y llamamos al método "AddText" para añadir el texto en cursiva y en negrita.

6. Finalmente añadimos el párrafo al documento utilizando el método "AddParagraph".

7. Luego guarde el documento como "save_document.docx"

   El ejemplo anterior muestra las fuentes y estilos que los desarrolladores pueden utilizar con IronWord, además de los efectos de texto en cursiva y negrita. IronWord también ofrece otras características para asegurar que los desarrolladores tengan todas las opciones para crear documentos de Word únicos en todos los escenarios.

Conclusión

Nuestras demostraciones mostraron lo fácil que es usar la IronWordbiblioteca para crear documentos de Word en C# programáticamente. La flexibilidad y escalabilidad de la biblioteca la convierten en una herramienta valiosa para los desarrolladores en escenarios reales, como personalizar el texto, la fuente y el estilo en un documento de Word. Comprender cómo Word se integra con otras aplicaciones ofrece a los desarrolladores soluciones adicionales a sus desafíos.

IronWord proporciona unlicencia de prueba gratuita.