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

Sin embargo, gestionar y crear documentos de Word no necesita ser tan difícil. IronWord es una biblioteca de Word para C# que no depende de Microsoft Office Word y permite a los usuarios personalizar el documento completo y también permite 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 programáticamente un documento Microsoft Word usando IronWord y proporcionaré breves ejemplos.

IronWord: Una biblioteca de Word en C#

IronWord es una biblioteca de Docx para C# 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 Interop. Además, cuenta con amplia documentación y proporciona soporte completo para .NET 8, 7, 6, Framework, Core y Azure, lo que lo hace compatible universalmente 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 tratando.

Configuración del entorno

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

Primero, crearemos una nueva aplicación de consola.

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

Finalmente, seleccione el marco de trabajo deseado.

Instalando la biblioteca de Word en C#

Después de crear la aplicación de consola en blanco, descargaremos IronWord a través del Administrador de paquetes NuGet.

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

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

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

Install-Package IronWord

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

Clave de licencia

Por favor, recuerde que IronWord requiere una clave de licencia para operar. Puede obtener una clave como parte de una prueba gratuita visitando este enlace.

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

Después de recibir una clave de prueba, configura esta variable en tu proyecto.

Crear un nuevo documento de 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

Explicación

1. Primero, importamos la biblioteca IronWord y sus modelos en el código de ejemplo.
2. Creamos una nueva variable Text. Esta variable nos permite agregar texto al documento de Word.
3. Luego añadimos el textRun a un Paragraph. Esto nos permite manipular fácilmente el texto al distinguir entre los dos.
4. Pasamos el parámetro paragraph a una nueva clase WordDocument para crear un nuevo objeto 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 funciones más avanzadas, como personalizar el texto y agregar efectos 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

Explicación del código

1. Como en el ejemplo anterior, creamos el objeto Text y añadimos el texto de muestra para el documento.
2. Luego creamos un nuevo objeto TextStyle y asignamos la propiedad IsItalic como true, indicando que el texto debe estar en cursiva.
3. Hacemos lo mismo para la variable boldText, asignando true a la propiedad IsBold.
4. Luego asignamos las variables TextStyle a sus respectivas variables Text.
5. Creamos una variable Paragraph y llamamos al método AddText para añadir el texto en cursiva y en negrita.
6. Añadimos el párrafo al documento usando el método AddParagraph.
7. Finalmente, guardamos el documento como "save_document.docx".

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

Conclusión

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

IronWord ofrece una licencia de prueba gratuita.