Como ler um arquivo do Word usando C#

How To Read a Word File Using C#

1. Crie uma Aplicação de Console no Visual Studio

2. Instale a biblioteca IronWord C# DOCX

3. Crie um novo documento Word usando a classe WordDocument

4. Adicione texto ao documento Word

5. Percorra cada parágrafo utilizando a classe Paragraph

6. Exiba o conteúdo

IronWord: A Biblioteca C# DOCX

IronWord é uma biblioteca flexível e escalável com uma API simples e fácil de usar que elimina a dificuldade de integrar documentos Word em aplicações. Quer você queira adicionar e integrar um documento Word de texto simples na sua aplicação ou criar tabelas e relatórios complexos para exibir aos usuários, o IronWord cobre tudo.

Aqui estão seus recursos mais notáveis:

1. Manipulação de Documentos: O IronWord permite que desenvolvedores manipulem documentos Word com facilidade. Quer os usuários queiram inserir parágrafos de texto ou estruturas mais complexas, como tabelas e imagens, o IronWord pode fazer tudo.

2. Suporte e Compatibilidade Multiplataforma: O IronWord é projetado para ser flexível e oferece suporte a desenvolvedores em várias plataformas. Ele suporta várias versões do .NET Core (8, 7, 6, 5 e 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+) e até mesmo Azure. Além disso, os desenvolvedores podem utilizar o IronWord em diferentes plataformas e sistemas, incluindo, mas não se limitando a, Windows, Linux, macOS e Android. Ele abrange as plataformas mais comuns e permite que os desenvolvedores construam aplicações multiplataforma rapidamente.

3. Independência do Microsoft Office: Um problema comum ao integrar documentos Word em aplicações .NET é que bibliotecas populares como Interop exigem uma instalação licenciada do Microsoft Office. No entanto, o IronWord alivia esse problema, sendo independente dessa restrição. Os desenvolvedores podem aproveitar totalmente o poder dos documentos Word sem serem restringidos pela licença e instalação do Microsoft Word.

4. Opções de Formatação: IronWord oferece amplo suporte para formatação e estilo, permitindo que os desenvolvedores tornem o documento único. Os desenvolvedores podem aplicar fontes ao seu texto, cores, alinhamentos e outros formatos complexos, como estilos de tabela.

5. Facilidade de Uso e Suporte Extensivo: Juntamente com uma API fácil de entender e chamadas de métodos diretas, o IronWord também fornece referências de API de extensão e exemplos de código para ajudar desenvolvedores a determinar a maneira mais ideal de utilizar o IronWord.

Criando um Novo Projeto de Console no Visual Studio

Antes de mergulharmos no exemplo, vamos começar criando um projeto de console em branco no Visual Studio.

Em seguida, fornecemos um nome e um local para salvar o projeto.

Em seguida, selecione o framework .NET que você usará. Neste exemplo, estarei usando .NET 8.0.

Após criar e configurar o novo projeto de console, vamos instalar nossa biblioteca de palavras C#, IronWord.

Instalando o IronWord

Existem duas maneiras de instalar o IronWord.

Install-Package IronWord

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

Reading Word Documents in C#

Após instalar os pré-requisitos, demonstraremos a simplicidade de ler um documento do Microsoft Word usando IronWord no código a seguir.

Primeiro, importamos os namespaces necessários. Usando IronWord, criamos um novo documento e adicionamos texto de exemplo. Em seguida, acessamos os parágrafos e textos usando o objeto WordDocument para imprimir o texto dentro do documento do Word.

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Create text run with sample text
Text textRunExample = new Text("Sample text");

// Create a paragraph and add the text run to it
Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

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

// Export the document as a DOCX file
doc.SaveAs("document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Create text run with sample text
Text textRunExample = new Text("Sample text");

// Create a paragraph and add the text run to it
Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

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

// Export the document as a DOCX file
doc.SaveAs("document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

Vamos explorar os métodos e parâmetros para ler arquivos Word do código acima.

1. Primeiro, criamos um objeto Text e atribuímos a ele a string "Texto de exemplo".

2. Em seguida, instanciamos um objeto Paragraph e adicionamos o "textRunExample" a ele.

3. Também instanciamos um objeto WordDocument, damos o nome de WordDocument doc, e passamos o paragraphExample para ele criar um novo documento do Word contendo o parágrafo.

4. O código salva o documento Word com o nome de arquivo "document.docx" para uso posterior.

5. Para acessar os parágrafos no documento Word que acabamos de criar, acessamos a propriedade "Paragraphs" do objeto WordDocument. A propriedade "Paragraphs" é uma lista. Portanto, chamamos um loop foreach para iterar por ela.

6. Para obter o texto dentro do parágrafo, acessamos a propriedade "Texts" de Paragraphs. Isso também retorna uma lista de Text.

7. Finalmente, atribuímos o Text a uma variável de string chamada "content" e o imprimimos no console.

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Load an existing Word document
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Load an existing Word document
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

Conclusão

Ao longo dos exemplos, demonstramos como é simples usar a biblioteca IronWord para manipular e ler documentos Word programaticamente em C#. A flexibilidade e escalabilidade da biblioteca IronWord fazem dela uma ferramenta valiosa que permite aos desenvolvedores usar IronWord em exemplos práticos e reais, como preencher templates, gerar relatórios e processar documentos em lote. Entender como o Word integra-se com aplicações é valioso, pois oferece aos desenvolvedores mais soluções para seus problemas.

Além disso, os desenvolvedores podem testar os amplos recursos do IronWord por um período antes de comprar, pois oferece uma licença de teste gratuito. Junto com a facilidade de uso, o IronWord também vem com documentação completa e suporte 24/5 para desenvolvedores, aliviando o sofrimento constante que os desenvolvedores podem enfrentar diante da produção. Também oferecemos vários tutoriais e uma gama de exemplos de código para referência e ajudar você a começar com IronWord.

Após testar vários aspectos do IronWord usando uma licença de teste, você pode adquirir nossa licença de desenvolvedor Lite que começa em $599 e vai desde Lite até Professional. Por favor, consulte nossa página de licenciamento para mais informações.