C#에서 Office Interop 없이 Word 문서를 만드는 방법

How to Create Word Documents Without Office Interop in C#

1. 새로운 C# 프로젝트를 만드세요.
2. IronWord 라이브러리를 설치합니다.
3. IronWord 라이브러리를 사용하여 Word 문서를 생성합니다.
4. 현재 있는 문서에 콘텐츠를 추가합니다.
5. 생성된 Word 문서를 저장합니다.
6. 생성된 Word 문서를 열고 표시합니다.

사전 요구사항:

1. Visual Studio: Visual Studio 또는 다른 C# 개발 환경이 설치되어 있는지 확인합니다.
2. NuGet 패키지 관리자: 프로젝트에서 패키지를 관리할 수 있도록 NuGet을 사용할 수 있는지 확인합니다.

1단계: 새로운 C# 프로젝트 생성

새로운 C# 콘솔 애플리케이션을 생성하거나 Word 문서를 생성하고자 하는 기존 프로젝트를 사용합니다.

콘솔 애플리케이션 템플릿을 선택하고 다음을 클릭하세요.

다음 단계에서는 솔루션 및 프로젝트 이름을 제공할 수 있습니다.

.NET 버전을 선택하고 '생성'을 클릭하세요.

2단계: IronWord 라이브러리 설치

C# 프로젝트를 열고 NuGet 패키지 관리자 콘솔을 사용하여 IronWord 라이브러리를 설치합니다.

Install-Package IronWord -Version 2024.1.2

아래와 같이 Visual Studio 패키지 관리자를 통해 NuGet 패키지를 설치할 수도 있습니다.

3단계: IronWord 라이브러리를 사용하여 Word 문서를 생성 및 저장

간단한 예제를 통해 IronWord 라이브러리를 사용하여 Word 문서를 생성하는 것으로 시작하겠습니다. 다음 코드는 텍스트 'Hello, World!'가 포함된 단일 문단의 기본 Word 문서를 생성하는 방법을 보여줍니다.

using IronWord;
using IronWord.Models;

// Create a text run instance with "Hello, World!" content
TextRun textRun = new TextRun("Hello, World!");

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

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

// Save the document as a .docx file
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

using IronWord;
using IronWord.Models;

// Create a text run instance with "Hello, World!" content
TextRun textRun = new TextRun("Hello, World!");

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

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

// Save the document as a .docx file
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

위의 코드 예제를 실행한 후, 새로운 문서 파일 example.docx이 생성되며 출력은 아래와 같습니다.

IronWord를 사용하여 Word 문서 파일을 생성하는 기본 예제입니다. 더 많은 정보를 원하시면 문서를 읽을 수 있습니다.

스타일이 적용된 문단을 Word 문서에 추가하기

이제 IronWord를 사용하여 간단한 Word 문서를 생성하는 방법을 알았으니 문단과 스타일이 적용된 텍스트를 추가해 봅시다.

TextRun은 스타일 데이터를 받을 수 있어 텍스트의 시각적 표현을 향상시킬 수 있습니다. 텍스트는 취소선, 굵게, 기울임꼴, 밑줄과 같은 스타일로 설정할 수 있습니다.

이전에 작성한 프로그램에 아래 코드를 추가 및 수정하십시오.

using IronWord;
using IronWord.Models;

// Create text runs with different styles
TextRun textRun = new TextRun("Hello, World!"); // Simple string
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Configure and add italic text
TextRun introText = new TextRun("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
    IsItalic = true
};
TextRun italicText = new TextRun("Italic example sentence.", italicStyle);

// Configure and add bold text
TextStyle boldStyle = new TextStyle()
{
    IsBold = true
};
TextRun boldText = new TextRun("Bold example sentence.", boldStyle);

// Add text runs to the paragraph
paragraph.AddTextRun(introText);
paragraph.AddTextRun(italicText);
paragraph.AddTextRun(boldText);

// Create and save the new Word document
WordDocument doc = new WordDocument(paragraph);
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

using IronWord;
using IronWord.Models;

// Create text runs with different styles
TextRun textRun = new TextRun("Hello, World!"); // Simple string
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Configure and add italic text
TextRun introText = new TextRun("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
    IsItalic = true
};
TextRun italicText = new TextRun("Italic example sentence.", italicStyle);

// Configure and add bold text
TextStyle boldStyle = new TextStyle()
{
    IsBold = true
};
TextRun boldText = new TextRun("Bold example sentence.", boldStyle);

// Add text runs to the paragraph
paragraph.AddTextRun(introText);
paragraph.AddTextRun(italicText);
paragraph.AddTextRun(boldText);

// Create and save the new Word document
WordDocument doc = new WordDocument(paragraph);
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

Word 문서에 테이블 추가하기

데이터를 명확하게 표현하기 위해, 데이터는 그리드 형태로도 나타낼 수 있습니다. 데이터가 그리드 형태로 배열될 때, 이를 테이블이라고 합니다. IronWord를 사용하여, 아래와 같이 Word 문서에 테이블과 이미지를 추가할 수 있습니다:

using IronWord;
using IronWord.Models;

// Create a table cell with sample text
TableCell cell = new TableCell();
TextRun textRun = new TextRun("Sample text");

// Add text run to the cell as a paragraph
cell.AddContent(new Paragraph(textRun));

// Configure cell border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};

// Set table borders
TableBorders tableBorders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
cell.Borders = tableBorders;

// Create a table row and add cells to it
TableRow row = new TableRow();
row.AddCell(cell); // Add the first cell
row.AddCell(cell); // Add the second cell, duplicating to mimic a row with two identical cells

// Create a table and add the row to the table
Table table = new Table();
table.AddRow(row);

// Create and save a Word document using the table
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx"); // Saves the file to disk with the name Document.docx

using IronWord;
using IronWord.Models;

// Create a table cell with sample text
TableCell cell = new TableCell();
TextRun textRun = new TextRun("Sample text");

// Add text run to the cell as a paragraph
cell.AddContent(new Paragraph(textRun));

// Configure cell border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};

// Set table borders
TableBorders tableBorders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
cell.Borders = tableBorders;

// Create a table row and add cells to it
TableRow row = new TableRow();
row.AddCell(cell); // Add the first cell
row.AddCell(cell); // Add the second cell, duplicating to mimic a row with two identical cells

// Create a table and add the row to the table
Table table = new Table();
table.AddRow(row);

// Create and save a Word document using the table
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx"); // Saves the file to disk with the name Document.docx

위 예제에서는 테두리를 사용하여 Word 문서에 테이블을 추가했습니다.

Word 문서에 이미지 추가하기

이미지는 문서의 프레젠테이션을 향상시키며, 더 많은 색상과 시각적 매력을 더할 수 있습니다.

이미지는 아래의 코드에서 보여주듯이 IronWord를 사용하여 Word 문서에 프로그래밍 방식으로 추가할 수 있습니다:

using IronWord;
using IronWord.Models;

// Load a new document
WordDocument doc = new WordDocument();

// Configure and add image to the document
IronWord.Models.Image image = new IronWord.Models.Image("SalesChart.jpg")
{
    Width = 200, // Set image width in pixels
    Height = 200 // Set image height in pixels
};
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image); // Add image to paragraph
doc.AddParagraph(paragraph); // Add paragraph to the document

// Save the document as a .docx file
doc.SaveAs("save_document.docx"); // Saves the file to disk with the name save_document.docx

using IronWord;
using IronWord.Models;

// Load a new document
WordDocument doc = new WordDocument();

// Configure and add image to the document
IronWord.Models.Image image = new IronWord.Models.Image("SalesChart.jpg")
{
    Width = 200, // Set image width in pixels
    Height = 200 // Set image height in pixels
};
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image); // Add image to paragraph
doc.AddParagraph(paragraph); // Add paragraph to the document

// Save the document as a .docx file
doc.SaveAs("save_document.docx"); // Saves the file to disk with the name save_document.docx

여기서는 IronWord.Models.Image을 사용하여 높이와 너비가 200 픽셀인 이미지를 단락에 추가하고 있습니다.

{
    "IronWord.LicenseKey": "IRONWORD.MYLICENSE.KEY.TRIAL"
}

결론

C#에서 IronWord 라이브러리를 사용하여 Word 문서를 생성하면 Microsoft Office에 의존하지 않고도 유연하고 효율적으로 문서를 생성할 수 있습니다. 간단한 편지부터 테이블이나 이미지를 포함한 복잡한 보고서까지, IronWord는 프로그래밍 방식으로 이를 가능하게 합니다. 이 기사에서는 Word 문서를 만드는 종합적인 튜토리얼을 제공합니다. IronWord를 사용하면 Word 문서 생성을 자동화할 수 있어 C# 응용 프로그램이 더욱 다양하고 생산적이 됩니다.

그리고 생성된 Word 문서와 함께 작동할 PDF 파일 조작에 관심 있는 개발자는 Iron Software에서 제작한 또 다른 C# 라이브러리인 IronPDF를 참고하면 됩니다.