1. IronWord
  2. 튜토리얼
  3. 문서 요소
C#에서 문서 요소를 다루는 방법

C# Document Element Tutorial

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord 는 .NET C# 개발자가 Word 및 DOCX 문서를 생성, 읽기 및 편집하는 기능을 애플리케이션에 통합할 수 있도록 지원하는 강력한 Word 문서 라이브러리입니다. 워드 문서에서 문서 요소는 콘텐츠를 구성하는 기본 구성 요소입니다.

빠른 시작: 스타일이 적용된 텍스트런을 만들고 이미지를 삽입하세요

IronWord 사용하여 스타일이 적용된 텍스트와 삽입된 이미지를 문서에 결합하는 풍부한 콘텐츠를 추가하는 방법을 소개합니다. 이 예제는 서식이 지정된 텍스트를 위한 Run 래퍼 패턴을 보여줍니다.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronWord 설치하기

    PM > Install-Package IronWord

  2. 다음 코드 조각을 복사하여 실행하세요.

    using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Create styled Run
Run textRun = new Run(new TextContent("Hello IronWord!"));
textRun.Style = new TextStyle() { IsBold = true, Color = Color.Blue };

// Create paragraph and add Run
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
paragraph.AddImage(new ImageContent("pic.png"));

// Add to document and save
doc.AddParagraph(paragraph);
doc.SaveAs("output.docx");

  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronWord 사용 시작하기

    arrow pointer

목차

핵심 개념

문서 계층 구조

IronWord는 Document → Paragraph → Run → TextContent와 같은 구조화된 문서 계층 구조를 따릅니다. 스타일이 적용된 텍스트를 다루려면 이러한 계층 구조를 이해하는 것이 필수적입니다.

  • WordDocument: 문서 전체를 나타내는 최상위 컨테이너
  • Paragraph: 문서 내의 콘텐츠 블록
  • Run: TextContent을 포함하며 스타일을 적용할 수 있는 래퍼 객체
  • TextContent: 실제 텍스트 문자열

단락에 내용 추가하기

IronWord 단락에 내용을 추가하는 두 가지 방법을 제공합니다.

  • AddText(TextContent): 서식이 적용되지 않은 일반 텍스트에 사용합니다. TextContent을 문단에 직접 삽입합니다.
  • AddChild(Run): 서식이 지정된 텍스트에 사용합니다. 단락에 Run 객체(TextContent를 감싸고 스타일을 포함하는)를 추가합니다.

글꼴 크기, 색상 또는 굵게 서식과 같은 스타일을 적용해야 할 경우, Run 객체를 생성하고, TextStyle를 Run에 할당한 다음, AddChild를 사용하여 해당 스타일을 단락에 적용하십시오.

TextRuns를 추가하세요

텍스트 내용

Split 메서드는 지정된 구분자를 기준으로 텍스트 블록을 더 작은 텍스트 블록들의 목록으로 분할하는 데 사용됩니다. 이를 통해 문서 내 텍스트 정보를 구성하고 조작할 수 있습니다.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-text-content.cs
using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();

// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));

// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));

// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));

// Export docx
doc.SaveAs("textrun.docx");
Imports IronWord
Imports IronWord.Models

Private doc As New WordDocument()

' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))

' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))

' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))

' Export docx
doc.SaveAs("textrun.docx")
$vbLabelText   $csharpLabel

스타일링 설정

텍스트 서식을 지정하려면 Run 래퍼 패턴을 사용해야 합니다. Run를 포함하는 TextContent 객체를 생성한 다음, TextStyle를 TextContent가 아님)에 할당합니다. TextStyle을 사용하면 FontSize, 색상, 굵게, 기울임꼴, 취소선, 밑줄, 위첨자 및 아래첨자와 같은 시각적 속성을 정의할 수 있습니다.

FontSize은 TextStyle 수준에서 구성되는 반면, FontFamily은 TextFont 속성 내부에 설정된다는 점에 유의하십시오. 서식이 지정된 후에는 AddChild을 사용하여 단락에 Run을 추가하십시오. 이 문서는 다음 문서 계층 구조를 따릅니다: Document → Paragraph → Run → TextContent.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
    FontSize = 72,
    TextFont = new Font()
    {
        FontFamily = "Caveat"
    },
    Color = Color.Red,
    IsBold = true,
    IsItalic = true,
    Underline = new Underline(),
    Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddChild(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Dim doc As New WordDocument("document.docx")

' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
    .FontSize = 72,
    .TextFont = New Font() With {
        .FontFamily = "Caveat"
    },
    .Color = Color.Red,
    .IsBold = True,
    .IsItalic = True,
    .Underline = New Underline(),
    .Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddChild(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")
$vbLabelText   $csharpLabel

텍스트 채우기 색상 가져오기

스타일 설정 외에도, IronWord는 기존 문서에서 RGBA 색상 값을 가져와 전체 스타일링의 일관성을 유지할 수 있는 방법을 제공합니다.

:path=/static-assets/word/content-code-examples/tutorials/rgba-color-value.cs
using IronWord;
using IronWord.Models;
using System;

// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");

TextContent content = doc.Paragraphs[0].Texts[0];

// This will show the R G B A of the themecolor
var filledColor = content.Color;

// Print the filled color variable to the console
Console.WriteLine(filledColor);
Imports IronWord
Imports IronWord.Models
Imports System

' Open existing Word
Dim doc As New WordDocument("Accent1TextThemcolor.docx")

Dim content As TextContent = doc.Paragraphs(0).Texts(0)

' This will show the R G B A of the themecolor
Dim filledColor = content.Color

' Print the filled color variable to the console
Console.WriteLine(filledColor)
$vbLabelText   $csharpLabel

색상 값을 가져오려면 WordDocument을 사용하여 문서를 로드한 다음, Paragraphs 컬렉션과 Texts 배열에 접근하여 TextContent 객체를 얻으십시오. Color 속성은 TextContent의 기존 텍스트 색상 값인 RGBA을 반환하므로, 문서 전체에 걸쳐 일관된 스타일을 유지할 수 있습니다.

이미지 삽입

이 기능을 사용하면 콘텐츠 내에 이미지를 매끄럽게 삽입할 수 있어 문서의 전반적인 시각적 매력과 전달력을 향상시킬 수 있습니다.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-embed-images.cs
using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();

// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);

// Add paragraph
doc.AddParagraph(new Paragraph(textRun));

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

' Configure image
Private image As New ImageContent("image.jpg")
image.Width = 200 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim textRun As New TextContent()

' Add image
Dim para As New Paragraph(textRun)
para.AddImage(image)

' Add paragraph
doc.AddParagraph(New Paragraph(textRun))

' Export docx
doc.SaveAs("save_document.docx")
$vbLabelText   $csharpLabel

이미지 추가

이미지 불러오기

이미지 로딩은 매우 중요한 과정입니다. 이 과정에는 외부 이미지 파일을 문서 안으로 가져오는 작업이 포함됩니다. 이미지 업로드 기능은 관련 시각 자료를 쉽게 포함할 수 있도록 해주어 더욱 매력적이고 유익한 문서를 만드는 데 기여합니다.

:path=/static-assets/word/content-code-examples/tutorials/add-image-load-image.cs
using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage("image.jpg");

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

Private paragraph As New Paragraph()

' Add image
paragraph.AddImage("image.jpg")

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")
$vbLabelText   $csharpLabel

이미지 구성

설정 가능한 옵션을 사용하여 이미지를 최적화하세요. 여기에는 텍스트 줄 바꿈, 크기, 위치 및 모서리와의 거리와 같은 속성 설정이 포함됩니다. 적절한 설정을 통해 이미지가 시각적으로 보기 좋고 맥락에 맞는 방식으로 표시될 수 있습니다.

:path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
using IronSoftware.Abstractions.Word;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.TextWrapBehavior = new TextWrapSquare();
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;

var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
Imports IronSoftware.Abstractions.Word

' Load docx
Dim doc As New WordDocument()

' Configure image
Dim image As New ImageContent("image.jpg")
image.TextWrapBehavior = New TextWrapSquare()
image.Width = 100
image.Height = 100
image.DistanceFromTop = 50

Dim position As New ElementPosition()
position.X = 50
position.Y = 50
image.Position = position

Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")
$vbLabelText   $csharpLabel

자주 묻는 질문

C#을 사용하여 Word 문서에 텍스트를 추가하려면 어떻게 해야 하나요?

IronWord를 사용하여 Word 문서에 텍스트 런 인스턴스를 생성하여 문서 내의 단락에 추가할 수 있습니다.

Word 문서에서 텍스트를 분할하는 방법은 무엇인가요?

IronWord는 Split 메서드를 제공하여 지정된 구분자를 기준으로 텍스트 런을 더 작은 세그먼트로 나눌 수 있어 텍스트 조작을 더욱 쉽게 합니다.

IronWord를 사용하여 Word 문서에서 텍스트를 스타일링하려면 어떻게 해야 하나요?

IronWord를 사용하여 글꼴 크기, 색상 및 볼드, 기울임꼴, 취소선, 밑줄, 위첨자, 아래첨자와 같은 스타일을 설정하여 텍스트를 스타일링할 수 있습니다.

C#을 사용하여 Word 문서에 이미지를 포함하려면 어떻게 해야 하나요?

IronWord를 사용하여 Word 문서에 이미지를 포함하는 경우 파일에서 이미지를 로드하고 문서 내의 단락에 인라인 이미지로 추가할 수 있습니다.

Word 문서에 이미지를 로드하는 단계는 무엇인가요?

IronWord를 사용하면 파일이나 파일 스트림에서 이미지를 로드할 수 있으며, 이를 통해 Word 문서에 시각적 콘텐츠를 통합할 수 있습니다.

Word 문서에서 이미지 속성을 어떻게 구성할 수 있나요?

IronWord를 사용하여 이미지 속성(text wrapping, dimensions, position offset, corners와의 거리)을 설정하여 문서 내에서 적절한 이미지 표시를 보장할 수 있습니다.

Word 문서의 텍스트에 대한 RGBA 색상 값을 검색할 수 있나요?

네, IronWord를 사용하여 문서 내의 기존 텍스트의 RGBA 색상 값을 얻을 수 있으며, 이를 통해 일정한 스타일을 유지할 수 있습니다.

IronWord를 사용하여 Word 문서 조작을 어떻게 시작하나요?

IronWord를 통해 .NET C# 애플리케이션에 통합하여 Word 문서를 생성, 읽기 및 편집할 수 있으며, 철저한 라이브러리 기능을 활용할 수 있습니다.

IronWord에 대해 Iron Software는 어떤 지원을 제공합니까?

Iron Software는 IronWord에 대한 포괄적인 지원을 제공하며, 개발자가 구현을 수행할 수 있도록 문서, 튜토리얼, 고객 지원을 제공합니다.

IronWord 무료 체험판이 있나요?

네, Iron Software는 IronWord를 구매 결정을 내리기 전에 기능과 역량을 탐색할 수 있도록 무료 체험판을 제공합니다.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 44,103 | 버전: 2026.5 just released
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronWord
샘플 실행 데이터를 워드 문서로 변환 확인.