Saltar al pie de página
  1. IronWord
  2. Blog de IronWord
  3. Usando IronWord
  4. VS 2022 Crear Nuevos Documentos de Word de Forma Programada
USANDO IRONWORD

VS 2022 Crear Nuevo Documentos Word Programáticamente (Tutorial)

Jordi Bardia
Jordi Bardia
Actualizado:

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: Biblioteca de palabras AC#

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.

Instalación de la biblioteca de palabras de 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"
$vbLabelText   $csharpLabel

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
$vbLabelText   $csharpLabel

VS 2022 Crear nuevos documentos de Word mediante programación (Tutorial): Figura 6 - Salida del ejemplo anterior

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 agregamos 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 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 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
$vbLabelText   $csharpLabel

VS 2022 Crear nuevos documentos de Word mediante programación (Tutorial): Figura 7 - Salida del código de ejemplo anterior

Explicación del código

  1. Al igual que 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 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 de TextStyle a sus respectivas variables Text.
  5. Creamos una variable Paragraph y llamamos al método AddText para agregar el texto en cursiva y negrita.
  6. Agregamos 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

VS 2022 Crear nuevos documentos de Word mediante programación (Tutorial): Figura 8 - Información de licencia de IronWord

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.

Preguntas Frecuentes

¿Cómo puedo crear un documento Microsoft Word de forma programada en C#?

Puede crear un documento Microsoft Word de forma programada en C# usando la biblioteca IronWord. Inicialice un objeto WordDocument, agregue el contenido necesario y use el método SaveAs para exportarlo como un archivo .docx.

¿Cuáles son los beneficios de usar IronWord sobre Microsoft Office Interop para la creación de documentos Word?

IronWord ofrece beneficios sobre Microsoft Office Interop al no requerir instalaciones de Microsoft Office, proporcionando mayor flexibilidad e integración más fácil a través de diferentes plataformas sin dependencia de Office.

¿Cómo instalo IronWord en Visual Studio?

Para instalar IronWord en Visual Studio, abra el Administrador de Paquetes NuGet, busque IronWord e instálelo en su proyecto. Alternativamente, use la línea de comando con Install-Package IronWord.

¿Puedo dar formato al texto en un documento Word usando IronWord?

Sí, puede dar formato al texto en un documento Word usando IronWord al utilizar el objeto TextStyle para aplicar varios estilos como itálica y negrita a los elementos de texto.

¿Es compatible IronWord con .NET y Azure?

Sí, IronWord es completamente compatible con .NET 8, 7, 6, Framework, Core y Azure, lo que lo hace versátil para varias aplicaciones.

¿Cómo puedo solucionar problemas de instalación con IronWord?

Si encuentra problemas de instalación con IronWord, asegúrese de estar usando una versión compatible de Visual Studio y .NET, y de que su Administrador de Paquetes NuGet esté actualizado. Verifique su conexión a internet y vuelva a intentar la instalación.

¿Qué se requiere para comenzar a crear documentos Word con IronWord?

Para comenzar a crear documentos Word con IronWord, importe la biblioteca IronWord y sus modelos en su proyecto C#. Luego, inicialice un objeto WordDocument para comenzar a construir su documento.

¿Cómo puedo agregar párrafos a un documento Word de forma programada usando IronWord?

Puede agregar párrafos a un documento Word de forma programada usando IronWord al crear objetos Paragraph, agregarles texto e incluirlos en el WordDocument.

Jordi Bardia
Jordi Bardia
  Chatea con el equipo de ingeniería ahora
Ingeniero de Software
Jordi es más competente en Python, C# y C++. Cuando no está aprovechando sus habilidades en Iron Software, está programando juegos. Compartiendo responsabilidades para pruebas de productos, desarrollo de productos e investigación, Jordi agrega un valor inmenso a la mejora continua del producto. La experiencia variada lo mantiene ...
Leer más

Artículos Relacionados

Prueba de 30 días → Producto completo. Sin límites. Sin tarjeta. Comenzar prueba gratuita