오늘날의 디지털 환경에서 많은 응용 프로그램은 문서를 자동으로 생성하고 수정할 수 있는 기능이 필요합니다. DOCX 파일을 생성하고 작업할 수 있는 것은 기업 규모의 보고 시스템, 문서 관리 시스템, 또는 단순히 반복적인 활동을 자동화하는데 유용합니다. 이 튜토리얼에서는 C# 문서 생성의 세계로 뛰어들어, C#에서 DOCX 파일을 생성할 수 있는 견고한 라이브러리와 프로그래밍 방법을 살펴보겠습니다.

How to Create DOCX File in C#

1. NuGet 패키지 IronWord를 설치합니다.
2. 필요한 네임스페이스를 가져와 IronWord에서 가져옵니다.
3. 문서 파일을 생성하려면 새 TextRun을 추가합니다.
4. 새 Body 및 Document를 만듭니다.
5. Body를 컨텐츠(단락, 표 등)로 채웁니다.
6. WordDocument를 사용하여 새 WordDocument를 생성합니다.
7. Document 개체를 TextRun, Paragraph Document 속성에 할당하여 수정 내용을 저장합니다.

DOCX 형식 알아가기

코딩을 깊이 파고들기 전에, DOCX 파일이 무엇인지 명확히 하겠습니다. Microsoft Word 및 기타 워드 프로세싱 프로그램은 DOCX 파일 형식으로 문서를 저장합니다. 이는 ZIP으로 압축된 XML 기반의 [Office Open XML (OOXML) 표준](https://en.wikipedia.org/wiki/Office_Open_XML#:~:text=Office%20Open%20XML%20(also%20informally,initial%20version%20as%20ECMA%2D376.)에 기반을 두고 있습니다. 이로 인해 Microsoft 및 기타 개발자의 API를 사용하여 이를 프로그래밍적으로 상대적으로 쉽게 다룰 수 있습니다.

IronWord

Iron Software에서는 IronWord라는 Word 문서 라이브러리를 만들었습니다. .NET 애플리케이션에서 Word 문서를 조작하는 강력한 기능을 제공할 때, IronWord는 빛나는 존재입니다. .NET C# 개발자가 자신의 프로그램에 Word 및 DOCX 문서를 생성, 읽기, 수정할 수 있는 기능을 포함시키도록 돕기 위해, IronWord는 견고한 Word 문서 라이브러리입니다.

IronWord의 기능

• DOC 및 DOCX 생성 및 편집: IronWord는 Office Interop이나 Microsoft Word 설치가 필요 없이, .NET 프로젝트 내에서 Word 문서를 생성하고 편집할 수 있게 해줍니다.
• 기존 문서를 열고, 편집하고, Word 파일 및 Docx 저장: Word 문서 구조는 페이지 설정(배경색, 여백, 용지 크기, 방향)을 포함하여 사용자 정의가 가능합니다.
• 단어 및 사진 포함: 간단한 API로 Word 문서에 텍스트와 그래픽을 빠르게 추가할 수 있습니다.
• 크로스 플랫폼 지원: IronWord는 .NET 8, 7, 6, Core, Standard 또는 Framework와 호환되며, C#, F#, VB.NET에 맞춰 설계되었습니다. 이것은 Docker, iOS, Android, Windows, Linux와 같은 여러 환경에서 작동합니다.
• 전 세계 수백만 명의 엔지니어들이 우리를 신뢰합니다: IronWord는 9개의 .NET API 오피스 문서 제품으로 구성된 Iron Suite의 구성 요소입니다. 개발자들은 전 세계적으로 이를 사용하여 Word 문서를 생성, 보기 및 수정합니다.

IronWord에 대해 더 알고 싶다면 여기를 참조하세요.

Visual Studio에서 새 프로젝트 생성하기

Visual Studio 애플리케이션을 시작하려면 파일 메뉴를 사용하여 파일을 선택하세요. "새 프로젝트"를 클릭한 다음 "콘솔 애플리케이션"을 선택하세요.

파일 위치를 선택한 후 지정된 텍스트 필드에 프로젝트 이름을 입력하십시오. 다음으로, 아래 샘플에서 볼 수 있듯이 'Create' 버튼을 클릭하고 필요한 .NET Framework를 선택하십시오.

Visual Studio 프로젝트의 구성은 선택된 애플리케이션에 따라 달라질 것입니다. 코드를 추가하고 애플리케이션을 구축하려면 프로그램.cs 파일을 열기만 하면 됩니다. 인터넷 애플리케이션, Windows 또는 콘솔에서 모두 사용할 수 있습니다.

그 후, 라이브러리를 추가하고 코드를 테스트할 수 있습니다.

IronWord 라이브러리 설치

시각적 스튜디오 도구 사용하기 도구 메뉴에서 NuGet 패키지 관리자를 선택합니다. 패키지 관리 인터페이스에 들어가서 패키지 관리 터미널 콘솔에 접근하십시오.

Install-Package IronWord

패키지를 다운로드하고 설치한 후, 현재 진행 중인 프로젝트에서 사용할 수 있습니다.

또한 패키지 관리자 방법이 있습니다. Visual Studio의 NuGet Package Manager 옵션을 사용하여 솔루션에 직접 패키지를 설치할 수 있습니다. 아래 이미지에서 NuGet Package Manager를 시작하는 방법을 볼 수 있습니다.

NuGet 웹사이트의 검색 상자를 사용하여 패키지를 찾습니다. 아래 스크린샷에서 설명하듯이 패키지 관리자에서 "IronWord"를 검색하면 됩니다:

관련 검색 결과 목록은 위 이미지에 표시됩니다. 이 설정을 조정하여 소프트웨어를 기기에 설치할 수 있습니다.

IronWord를 사용하여 DOCX 생성

새 Word 문서를 시작하기 위해 WordDocument 객체를 인스턴스화합니다. 문서를 초기화하려면 단락, 표, 섹션과 같은 문서 구조를 구성하는 객체를 사용할 수 있습니다. 다음 코드 예제에서 간단한 설명을 확인할 수 있습니다:

using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

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

            // Export and save the DOCX file to the specified path.
            doc.SaveAs("document.docx");
        }
    }
}

using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

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

            // Export and save the DOCX file to the specified path.
            doc.SaveAs("document.docx");
        }
    }
}

Imports IronWord
Imports IronWord.Models

Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run, which is a portion of the document's text content.
			Dim textRun As New TextRun("Hello, IronWord!")

			' Create a paragraph and add the text run to it.
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)

			' Create a new Word document with the paragraph.
			Dim doc As New WordDocument(paragraph)

			' Export and save the DOCX file to the specified path.
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace

Imports IronWord
Imports IronWord.Models

Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run, which is a portion of the document's text content.
			Dim textRun As New TextRun("Hello, IronWord!")

			' Create a paragraph and add the text run to it.
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)

			' Create a new Word document with the paragraph.
			Dim doc As New WordDocument(paragraph)

			' Export and save the DOCX file to the specified path.
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace

우리는 TextRun 클래스를 통해 문서에 텍스트를 추가할 수 있으며, AddTextRun 메소드를 활용하여 텍스트를 단락 객체에 전달할 수 있습니다. 이후 새 DOCX 파일을 생성하기 위해 새로운 WordDocument 객체를 생성합니다. 그런 다음 SaveAs 메소드를 사용하여 새로운 DOCX 문서를 원하는 위치에 저장할 수 있습니다. 다음은 위 코드의 실행 결과입니다.

IronWord 코드에 대해 더 알고 싶다면 여기를 참조하십시오.

결론

이 가이드에서는 C#을 사용하여 DOCX 문서 파일을 생성하는 방법을 살펴보았습니다. DOCX 형식의 기본 사항, Open XML SDK, DocX 라이브러리 및 이를 사용하여 DOCX 파일을 생성, 수정 및 저장하는 방법에 대한 예시가 제공되었습니다.

이 모든 도구와 방법은 C# 프로젝트에서 다양한 문서 생성 작업을 처리하는 데 도움이 될 것입니다. C#에서 문서 제작을 배우는 것은 문서 관리 시스템을 개발하거나 엔드 사용자를 위한 템플릿을 만드는 등 다양한 상황에서 유용한 능력이 될 것입니다.

.NET C#에서 작업하는 개발자를 위해, IronWord는 강력하고 적응력 있는 Word 문서 라이브러리입니다. 개발자가 앱에서 Word (DOCX) 문서를 쉽게 읽고, 작성하고, 편집할 수 있게 합니다. IronWord의 사용자 친화적인 API는 Word 문서 처리를 더 쉽게 만듭니다. Microsoft Word를 설치하거나 Office Interop에 의존하지 않고도 개발자는 .NET 프로젝트 내에서 Word 파일을 직접 생성하고 편집할 수 있습니다. 새 Word 문서에 텍스트, 단락 및 기타 요소를 추가하는 것이 간단합니다.

IronWord는 처음 출시되었을 때 $999입니다. 추가로, 1년 구독료를 지불하는 고객은 제품 지원 및 업데이트를 받을 수 있습니다. 비용을 지불하면 IronWord는 무제한 재배포에 대한 방어를 제공합니다. 대략적인 비용에 대해 더 알아보려면, 이 페이지를 참조하십시오. Iron Software에 대해 더 보려면 이 링크를 클릭하십시오.