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, uno de esos contendientes que destaca sobre el resto es IronWord. IronWord es una fiable y robusta librería C# Word DOCX fácil de usar y entender, que simplifica el trabajo con documentos Word.

Este artículo explorará cómo podemos utilizar rápidamente IronWord 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. Crear un nuevo documento Word utilizando la clase WordDocument

4. Añadir texto al documento Word

5. Recorrer cada párrafo utilizando la clase Párrafo.

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 la molestia 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 compatible con desarrolladores de múltiples plataformas. Soporta 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 Word en aplicaciones .NET es que librerías populares como Interop requieren una instalación con licencia 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 amplio soporte para el formato y el estilo, lo que permite a los desarrolladores hacer que el documento sea único. Los promotores pueden solicitar fuentes a su texto, colores, alineaciones y otros formatos complejos, como estilos de mesa.

5. **Junto con una API fácil de entender y llamadas a métodos sencillos, IronWord también proporciona referencias a la API de extensión y ejemplos de código para ayudar a los desarrolladores a determinar la forma más óptima de utilizar IronWord.

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

Antes de sumergirnos en el ejemplo, empecemos por crear 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, vamos a instalar nuestra librería word de 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 Gestor de Paquetes NuGet, hacemos clic en herramientas y luego en Gestionar Soluciones NuGet. A continuación 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 uno aquí como parte de un 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#

Tras instalar los requisitos previos, demostraremos la sencillez 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. A continuación accedemos a los párrafos y al texto utilizando el objeto `WordDocument` para imprimir el texto dentro del documento 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 Texto y le asignamos la cadena "Texto de muestra".

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

3. También instanciamos un objeto WordDocument, lo llamamos `WordDocument doc,` y le pasamos el `ejemplo de párrafo`` para crear un nuevo documento 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 del documento 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 "Textos" de Párrafos. Esto también devuelve una lista de Texto.

7. Por último, asignamos el Texto a una variable de cadena llamada "contenido" y lo imprimimos en la consola.

Salida de la consola

Lectura de un documento 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 que se pasa 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, hemos demostrado lo sencillo que es utilizar la función IronWord para manipular y leer documentos de Word mediante programación en C#. La flexibilidad y escalabilidad de la biblioteca IronWord la convierten en una valiosa herramienta que permite a los desarrolladores utilizar IronWord en ejemplos prácticos y reales, como rellenar plantillas, generar informes y procesar documentos por 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 amplias funciones de IronWord durante un periodo de tiempo antes de comprarlo, ya que ofrece un **Prueba gratuita licencia. Además de su facilidad de uso, IronWord también incluye documentación y 24/5 apoyo para los desarrolladores, aliviando la frustración constante a la que pueden enfrentarse los desarrolladores de cara a la producción. También ofrecemos varios tutoriales y una gama de ejemplos de código como referencia para ayudarle a empezar a utilizar IronWord.

Tras probar varios aspectos de IronWord utilizando una licencia de prueba, puede adquirir nuestra licencia Lite para desarrolladores que comienza en 599 dólares y va de Lite a Professional. Consulte nuestro licencia para más información.