Cómo leer un archivo de Word con C#

En la era actual, los documentos de Microsoft Word son sinónimo de trabajo de oficina y comunicación profesional y personal. Por lo tanto, la manipulación programática de documentos Word es fundamental para los desarrolladores que buscan automatizar tareas para mostrar a los usuarios en sus aplicaciones. Aunque hay muchas bibliotecas disponibles, no todas son tan sólidas como las demás. Sin embargo, un contendiente que destaca del resto es IronWord. IronWord es una biblioteca de C# para documentos Word DOCX confiable y robusta, que es fácil de usar y entender, y simplifica el trabajo con documentos de Word.

Este artículo explorará cómo podemos utilizar rápidamente IronWord para leer documentos Word con ejemplos breves.

Cómo leer un archivo de Word usando C#

1. Crear una aplicación de consola en Visual Studio

2. Instalar la biblioteca DOCX IronWord C#

3. Cree un nuevo documento de Word usando la clase WordDocument

4. Añadir texto al documento Word

5. Recorre cada párrafo usando la clase Paragraph

6. Visualizar el contenido

IronWord: La biblioteca DOCX de C

IronWord es una biblioteca flexible y escalable con una API sencilla y fácil de usar que elimina las complicaciones de integrar documentos de Word en las aplicaciones. Tanto si desea añadir e integrar un simple documento de texto Word en su aplicación como crear tablas e informes complejos para mostrar a los usuarios, IronWord lo tiene todo cubierto.

Estas son sus características más destacadas.

1. Manipulación de documentos: IronWord permite a los desarrolladores manipular documentos de Word con facilidad. Tanto si los usuarios desean insertar párrafos de texto como estructuras más complejas, como tablas e imágenes, IronWord puede hacerlo todo.

2. Compatibilidad y soporte multiplataforma: IronWord está diseñado para ser flexible y admite a los desarrolladores en múltiples plataformas. Admite varios .NET Core (8, 7, 6, 5 y 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+) e incluso Azure. Además, los desarrolladores pueden utilizar IronWord en diferentes plataformas y sistemas, incluidos, entre otros, Windows, Linux, macOS y Android. Cubre las plataformas más comunes y permite a los desarrolladores crear aplicaciones multiplataforma con rapidez.

3. Independencia de Microsoft Office: Un problema común al integrar documentos de Word en aplicaciones .Net es que bibliotecas populares como Interop requieren una instalación licenciada de Microsoft Office. Sin embargo, IronWord alivia ese problema al ser independiente de esa restricción. Los desarrolladores pueden aprovechar al máximo la potencia de los documentos de Word sin estar limitados por la licencia y la instalación de Microsoft Word.

4. Opciones de Formato: IronWord ofrece un extenso soporte para formato y estilo, lo que permite a los desarrolladores hacer que el documento sea único. Los desarrolladores pueden aplicar fuentes a su texto, colores, alineaciones y otros formatos complejos, como estilos de tabla.

5. Facilidad de uso y soporte extenso: Junto con una API fácil de entender y llamadas de método directas, IronWord también proporciona referencias de API de extensión y ejemplos de código para ayudar a los desarrolladores a determinar la manera más óptima de utilizar IronWord.

Creación de un nuevo proyecto de consola en Visual Studio

Antes de sumergirnos en el ejemplo, comencemos creando un proyecto de consola en blanco en Visual Studio.

A continuación, proporcionamos un nombre y una ubicación para guardar el proyecto.

A continuación, seleccione el .NET Framework que va a utilizar. En este ejemplo, utilizaré .NET 8.0.

Después de crear y configurar el nuevo proyecto de consola, instalemos nuestra biblioteca de palabras en C#, IronWord.

Instalación de IronWord

Hay dos formas de instalar IronWord.

1. Instalación mediante el gestor de paquetes NuGet

Para instalarlo a través del Administrador de Paquetes NuGet, haga clic en herramientas y luego en `Administrar soluciones NuGet.` Luego buscamos IronWord en la barra de búsqueda e instalamos `IronWord.`

2. Instalación a través de la consola del gestor de paquetes NuGet

Un método alternativo es instalarlo a través de la consola del gestor de paquetes NuGet. Para ello, ejecute el siguiente comando en la consola:

Install-Package IronWord

Install-Package IronWord

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

Clave de licencia

Tenga en cuenta que IronWord no funciona sin una clave de licencia; puede obtener una aquí como parte de una prueba gratuita.

Después de obtener una clave de rastro, asegúrese de que esta variable está configurada en su proyecto.

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

Lectura de documentos Word en C#

Después de instalar los requisitos previos, demostraremos la simplicidad de leer un documento de Microsoft Word utilizando IronWord en el siguiente código.

En primer lugar, importamos el siguiente espacio de nombres. Con IronWord, creamos un nuevo documento y añadimos un texto de muestra. Luego accedemos a los párrafos y al texto utilizando el objeto WordDocument para imprimir el texto dentro del documento de Word.

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion
// Create textrun
Text textRunExample = new Text("Sample text");

Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

// Create a new Word document
WordDocument doc = new WordDocument(paragraphExample);

// Export docx
doc.SaveAs("document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion
// Create textrun
Text textRunExample = new Text("Sample text");

Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

// Create a new Word document
WordDocument doc = new WordDocument(paragraphExample);

// Export docx
doc.SaveAs("document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Exploremos los métodos y parámetros para leer archivos word desde el código anterior.

1. Primero creamos un objeto Text y le asignamos la cadena "Texto de Ejemplo".

2. A continuación, instanciamos un objeto Paragraph y le añadimos el "textRunExample".

3. También instanciamos un objeto WordDocument, lo nombramos `WordDocument doc,` y le pasamos el `paragraphExample` para crear un nuevo documento de Word que contenga el párrafo.

4. El código guarda el documento Word con el nombre de archivo "documento.docx" para su uso posterior.

5. Para acceder a los párrafos en el documento de Word que acabamos de crear, accedemos a la propiedad "Paragraphs" del objeto WordDocument. La propiedad "Párrafos" es una lista. Por lo tanto, llamamos a un bucle foreach para iterar a través de ella.

6. Para obtener el texto dentro del párrafo, accedemos a la propiedad "Texts" de Paragraphs. Esto también devuelve una lista de Text.

7. Finalmente, asignamos el Texto a una variable de cadena llamada "content" y lo imprimimos en la consola.

Salida de la consola

Leer un documento de Word existente en C

En el ejemplo anterior, creamos mediante programación un nuevo documento Word y leímos su contenido. Podemos seguir pasos similares para leer un documento Word existente realizando unos pocos cambios en el código.

Documento de entrada

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Export docx
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Export docx
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

La principal diferencia entre los dos ejemplos es el parámetro pasado al objeto WordDocument. En lugar de crear un nuevo documento, cargamos en él un archivo Word existente. El resto es igual que en el otro ejemplo.

Salida de la consola

Conclusión

A lo largo de los ejemplos, demostramos lo sencillo que es utilizar la biblioteca IronWord para manipular y leer documentos de Word de manera programática en C#. La flexibilidad y escalabilidad de la biblioteca IronWord la convierten en una herramienta valiosa que permite a los desarrolladores utilizar IronWord en ejemplos prácticos y reales, como llenar plantillas, generar informes y procesar documentos en lotes. Comprender cómo se integra Word con las aplicaciones es muy valioso, ya que permite a los desarrolladores encontrar más soluciones a sus problemas.

Además, los desarrolladores pueden probar las extensas características de IronWord durante un periodo de tiempo antes de comprarlo, ya que ofrece una licencia de prueba gratuita. Junto con su facilidad de uso, IronWord también viene con una documentación exhaustiva y soporte 24/5 para desarrolladores, aliviando la constante frustración que los desarrolladores pueden enfrentar en el entorno de producción. También ofrecemos varios tutoriales y una variedad de ejemplos de código como referencia para ayudarte a comenzar con IronWord.

Después de probar varios aspectos de IronWord utilizando una licencia de prueba, puede adquirir nuestra licencia de desarrollador Lite que comienza en $599 y va desde Lite hasta Professional. Consulte nuestra página de licencias para obtener más información.