C#을 사용하여 워드 파일을 읽는 방법

How To Read a Word File Using C#

1. Visual Studio에서 콘솔 응용 프로그램 생성

2. IronWord C# DOCX 라이브러리 설치

3. WordDocument 클래스를 사용하여 새로운 Word 문서 생성

4. Word 문서에 텍스트 추가

5. Paragraph 클래스를 사용하여 각 단락을 반복

6. 내용을 표시합니다

IronWord: C# DOCX 라이브러리

IronWord는 Word 문서를 애플리케이션에 통합하는 번거로움을 없애 주는 간단하고 사용하기 쉬운 API를 가진 유연하고 확장 가능한 라이브러리입니다. 단순한 텍스트 Word 문서를 애플리케이션에 통합하거나 사용자를 위한 복잡한 표와 보고서를 생성하고자 할 때 IronWord는 모든 것을 다룹니다.

다음은 가장 주목할 만한 기능들입니다:

1. 문서 조작: IronWord는 개발자가 Word 문서를 쉽게 조작할 수 있도록 합니다. 사용자가 텍스트 단락을 삽입하거나 표 및 이미지와 같은 더 복잡한 구조물을 삽입하고 싶어하는지 여부와 관계없이 IronWord는 모든 작업을 수행할 수 있습니다.

2. 크로스 플랫폼 지원 및 호환성: IronWord는 다양한 플랫폼에서 개발자를 지원하도록 설계되었습니다. 다양한 .NET Core (8, 7, 6, 5 및 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+) 및 Azure까지 지원합니다. 또한, 개발자는 Windows, Linux, macOS 및 Android를 포함하되 이에 국한되지 않는 다양한 플랫폼 및 시스템에서 IronWord를 활용할 수 있습니다. 가장 일반적인 플랫폼을 다루며, 개발자가 크로스 플랫폼 애플리케이션을 빠르게 구축할 수 있도록 합니다.

3. Microsoft Office로부터의 독립성: .NET 애플리케이션에 Word 문서를 통합할 때 일반적인 문제는 Interop과 같은 인기 있는 라이브러리가 Microsoft Office의 라이센스 설치를 필요로 한다는 것입니다. 그러나 IronWord는 이 제한이 없는 상태로 그 문제를 완화합니다. 개발자는 Microsoft Word의 라이센스 및 설치에 구애받지 않고 Word 문서의 힘을 완전히 이용할 수 있습니다.

4. 서식 옵션: IronWord는 서식 및 스타일링에 대한 광범위한 지원을 제공하여 개발자가 문서를 독특하게 만들 수 있도록 합니다. 개발자는 그들의 텍스트, 색상, 정렬 및 표 스타일과 같은 다른 복잡한 서식을 적용할 수 있습니다.

5. 사용의 용이성과 광범위한 지원: 이해하기 쉬운 API와 간단한 메서드 호출과 함께 IronWord는 확장 API 참조와 코드 예제를 제공하여 개발자가 IronWord를 활용하는 가장 최적의 방법을 결정하는 데 도움을 줍니다.

Visual Studio에서 새로운 콘솔 프로젝트 생성

예제에 들어가기 전에 Visual Studio에서 빈 콘솔 프로젝트를 생성하는 것으로 시작하겠습니다.

그런 다음 프로젝트의 이름과 저장 위치를 지정합니다.

다음으로 사용할 .NET Framework를 선택합니다. 이 예제에서는 .NET 8.0을 사용할 것입니다.

새 콘솔 프로젝트를 만들고 설정한 후 C# 워드 라이브러리인 IronWord를 설치하겠습니다.

IronWord 설치 중

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#

필수 구성 요소를 설치한 후, 아래 코드를 사용하여 IronWord를 사용하여 마이크로소프트 워드 문서를 읽는 간단함을 보여드리겠습니다.

먼저 필요한 네임스페이스를 가져옵니다. IronWord를 사용하여 새 문서를 만들고 샘플 텍스트를 추가합니다. 그런 다음 WordDocument 객체를 사용하여 단락과 텍스트에 접근하여 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);
    }
}

위의 코드에서 워드 파일을 읽는 방법과 매개변수를 탐색해봅시다.

1. 먼저 Text 객체를 생성하고 "Sample text" 문자열을 할당합니다.

2. 그런 다음 Paragraph 객체를 인스턴스화하고 "textRunExample"을 추가합니다.

3. 또한 WordDocument 객체를 생성하고, WordDocument doc,으로 이름을 지정한 후, 단락을 포함하는 새 Word 문서를 생성하기 위해 paragraphExample를 전달합니다.

4. 해당 코드는 워드 문서를 "document.docx" 파일명으로 저장하여 나중에 사용할 수 있도록 합니다.

5. 방금 만든 워드 문서의 단락에 엑세스하려면 WordDocument 객체의 "Paragraphs" 속성에 접근합니다. "Paragraphs" 속성은 리스트입니다. 따라서 이를 반복하기 위해 foreach 루프를 호출합니다.

6. 단락 내의 텍스트를 얻으려면 Paragraphs의 "Texts" 속성에 엑세스합니다. 이것도 Text의 리스트를 반환합니다.

7. 마지막으로 Text를 "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);
    }
}

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);
    }
}

결론

예제 전반에 걸쳐 IronWord 라이브러리를 사용하여 C#에서 워드 문서를 프로그래밍 방식으로 조작하고 읽는 것이 얼마나 간단한지를 보여드렸습니다. IronWord 라이브러리의 유연성과 확장성은 개발자가 템플릿 채우기, 보고서 생성, 문서 일괄 처리와 같은 실생활 예제에서 IronWord를 사용할 수 있게 해주는 유용한 도구입니다. 워드가 응용 프로그램과 어떻게 통합되는지를 이해하는 것은 개발자에게 더 많은 문제 해결책을 제공하므로 가치가 있습니다.

또한 개발자는 무료 체험판 라이선스를 통해 구매 전 일정 기간 동안 IronWord의 광범위한 기능을 테스트할 수 있습니다. 사용의 용이성과 함께, IronWord는 개발자를 위해 철저한 문서 및 24/5 지원을 제공하여 제작 중 개발자가 직면할 수 있는 지속적인 좌절을 해소합니다. 우리는 또한 여러 튜토리얼과 코드 예제를 제공하여 IronWord를 시작하는 데 도움이 됩니다.

시험 라이선스를 사용하여 IronWord의 다양한 측면을 테스트한 후, $599부터 시작하는 Lite 개발자 라이선스를 구매하고 Lite에서 Professional까지 상향할 수 있습니다. 자세한 내용은 저희 라이선스 페이지를 참조하세요.