IronWord 와 Microsoft.Office.Interop.Word 비교

7.1.1 문서 읽기 및 편집

IronWord는 문서 수정을 포함하여 문서를 읽을 수 있게 해줍니다. 이는 기존 문서를 열고 변경을 한 후, 원본 문서 또는 새 파일로 변경 내용을 저장하는 것을 포함합니다. 이는 사용자 입력 또는 다른 소스의 데이터에 따라 문서를 업데이트해야 하는 응용 프로그램에 필수적입니다.

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument("my_new_document.docx");

// Insert new text content into the document
document.AddText("This is a demonstration of modifying content with IronWord.");

// Save the document with a new filename
document.SaveAs("updated_document.docx");

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument("my_new_document.docx");

// Insert new text content into the document
document.AddText("This is a demonstration of modifying content with IronWord.");

// Save the document with a new filename
document.SaveAs("updated_document.docx");

7.1.2 페이지 설정 편집

IronWord는 A4, 레터, 법률과 같은 다양한 표준을 수용하여 문서의 용지 크기를 변경할 수 있습니다. 문서 요구 사항에 따라 페이지 방향을 세로와 가로로 조정할 수 있습니다.

7.1.3 단락 추가

단락 추가는 IronWord를 사용하여 프로그래밍적으로 간단하며, 이는 응용 프로그램 논리에 따라 동적으로 텍스트를 삽입할 수 있게 해줍니다.

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument();

// Insert text into the document
document.AddText("Exploring IronWord Capabilities");

// Save the document to a new file
document.SaveAs("updated_ironword_document.docx");

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument();

// Insert text into the document
document.AddText("Exploring IronWord Capabilities");

// Save the document to a new file
document.SaveAs("updated_ironword_document.docx");

7.1.4 텍스트런 추가 및 제거

텍스트런은 공통 속성을 가진 텍스트 섹션을 나타냅니다. IronWord는 이들을 추가 및 제거할 수 있으며, 개발자가 텍스트 세분화 및 속성을 제어할 수 있게 해줍니다.

7.1.5 이미지 추가

IronWord는 문서에 이미지를 추가하는 것을 지원하며, 이것은 위치, 감싸기 및 크기를 지정할 수 있으며, 문서의 시각적 매력과 효과를 향상시킵니다.

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument();

// Setup an image
IronWord.Models.Image img = new IronWord.Models.Image("updated_image.jpg");
img.Width = 250; // Width in pixels
img.Height = 250; // Height in pixels

// Create a paragraph to contain the image
Paragraph para = new Paragraph();
// Incorporate an image into the paragraph
para.AddImage(img);

// Add the paragraph to the document
document.AddParagraph(para);

// Save the document with a new name
document.SaveAs("updated_save_document.docx");

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument();

// Setup an image
IronWord.Models.Image img = new IronWord.Models.Image("updated_image.jpg");
img.Width = 250; // Width in pixels
img.Height = 250; // Height in pixels

// Create a paragraph to contain the image
Paragraph para = new Paragraph();
// Incorporate an image into the paragraph
para.AddImage(img);

// Add the paragraph to the document
document.AddParagraph(para);

// Save the document with a new name
document.SaveAs("updated_save_document.docx");

7.1.6 도형 추가

IronWord를 사용하여 문서에 도형을 추가할 수 있으며, 도형 유형, 크기, 위치 및 회전을 설정할 수 있습니다. 이는 시각적 흥미층을 추가하며 정보를 강조하거나 장식 요소를 추가하는 데 사용할 수 있습니다.

7.1.7 스타일 설정

스타일링 옵션은 IronWord에서 광범위하게 제공되며, 글꼴 패밀리 및 크기, 색상, 굵게, 기울임꼴, 취소선, 밑줄, 윗첨자, 아래첨자와 같은 텍스트 장식이 포함됩니다. 이러한 수준의 제어는 브랜드 표준 유지와 문서 가독성을 보장하는 데 필수적입니다.

using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;
using Color = IronSoftware.Drawing.Color;

// Initialize WordDocument with a file
WordDocument document = new WordDocument("updated_document.docx");

// Create a TextRun with modifications
TextRun modifiedTextRun = new TextRun
{
    Text = "Updated text with IronWord",
    Style = new TextStyle
    {
        FontFamily = "Arial",
        FontSize = 48, // Adjusted font size
        TextColor = new IronColor(Color.Blue),
        IsBold = false,
        IsItalic = false,
        IsUnderline = false,
        IsSuperscript = true,
        IsStrikethrough = false,
        IsSubscript = true
    }
};

// Create a paragraph and add the TextRun
Paragraph newParagraph = new Paragraph();
newParagraph.AddTextRun(modifiedTextRun);

// Add the paragraph to the document
document.AddParagraph(newParagraph);

// Save the document with a new name
document.SaveAs("updated_save_document.docx");

using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;
using Color = IronSoftware.Drawing.Color;

// Initialize WordDocument with a file
WordDocument document = new WordDocument("updated_document.docx");

// Create a TextRun with modifications
TextRun modifiedTextRun = new TextRun
{
    Text = "Updated text with IronWord",
    Style = new TextStyle
    {
        FontFamily = "Arial",
        FontSize = 48, // Adjusted font size
        TextColor = new IronColor(Color.Blue),
        IsBold = false,
        IsItalic = false,
        IsUnderline = false,
        IsSuperscript = true,
        IsStrikethrough = false,
        IsSubscript = true
    }
};

// Create a paragraph and add the TextRun
Paragraph newParagraph = new Paragraph();
newParagraph.AddTextRun(modifiedTextRun);

// Add the paragraph to the document
document.AddParagraph(newParagraph);

// Save the document with a new name
document.SaveAs("updated_save_document.docx");

7.1.8 정렬 설정

IronWord는 문서 내에서 왼쪽, 가운데, 오른쪽 및 양쪽 정렬을 포함한 텍스트 정렬 설정을 지원합니다. 이는 미적 감각과 가독성 모두에 중요합니다.

7.1.10 테이블 추가

테이블은 많은 문서에서 데이터를 정리하고 정보를 제공하기 위해 사용하는 중요한 구성 요소입니다. IronWord는 테이블 추가 및 구조 조작을 허용하며, 행과 열의 추가 또는 제거도 가능합니다. IronWord를 사용하면 테이블 셀의 내용을 조작하는 것이 간단하여 애플리케이션 필요에 따라 동적 콘텐츠 삽입이 가능합니다. IronWord는 테이블 셀을 병합하고 분할하는 기능을 제공하므로 테이블 레이아웃을 사용자 지정하거나 복잡한 데이터 프레젠테이션 요구를 해결하는 데 유용합니다.

using IronWord;
using IronWord.Models;

// Create a table cell
TableCell cell = new TableCell();
TextRun textRun = new TextRun();
textRun.Text = "Updated content"; // Changed the text content

// Add a TextRun to the cell
cell.AddContent(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Blue), // Changed border color to blue
    BorderValue = IronWord.Models.Enums.BorderValues.Double, // Changed border style to double
    BorderSize = 3 // Adjusted border size to 3
};

// Configure table border
TableBorders tableBorders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

// Assign borders to the cell
cell.Borders = tableBorders;

// Create a row and add the cell
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);

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

// Create a new Word document from the table
WordDocument doc = new WordDocument(table);

// Export the Word document
doc.SaveAs("UpdatedDocument.docx");

using IronWord;
using IronWord.Models;

// Create a table cell
TableCell cell = new TableCell();
TextRun textRun = new TextRun();
textRun.Text = "Updated content"; // Changed the text content

// Add a TextRun to the cell
cell.AddContent(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Blue), // Changed border color to blue
    BorderValue = IronWord.Models.Enums.BorderValues.Double, // Changed border style to double
    BorderSize = 3 // Adjusted border size to 3
};

// Configure table border
TableBorders tableBorders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

// Assign borders to the cell
cell.Borders = tableBorders;

// Create a row and add the cell
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);

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

// Create a new Word document from the table
WordDocument doc = new WordDocument(table);

// Export the Word document
doc.SaveAs("UpdatedDocument.docx");

Microsoft.Office.Interop.Word는 Word 문서와의 깊은 통합을 허용하여 개발자가 Word의 다양한 기능을 코드로 활용할 수 있도록 합니다. 아래는 Microsoft.Office.Interop.Word에서 제공하는 특정 고급 기능들로, 이전에 기술한 일반 기능과는 구별됩니다:

7.2.1 콘텐츠 제어

Microsoft.Office.Interop.Word는 리치 텍스트 박스, 콤보 박스, 날짜 선택기 및 체크박스를 포함하는 콘텐츠 제어의 추가와 조작을 지원합니다. 이러한 제어는 구조화되고 대화형인 문서를 생성하는 데 사용할 수 있으며, 사용자가 설정된 템플릿 내에서 정보를 입력하거나 선택할 수 있도록 합니다.

using Microsoft.Office.Interop.Word;

// Create a new Word application and document
var application = new Application();
var document = application.Documents.Add();

// Add a combo box content control
object missing = System.Reflection.Missing.Value;
var cc = document.ContentControls.Add(WdContentControlType.wdContentControlComboBox, ref missing);
cc.Title = "Choose an option";
cc.DropdownListEntries.Add("Option 1", "1");
cc.DropdownListEntries.Add("Option 2", "2");

using Microsoft.Office.Interop.Word;

// Create a new Word application and document
var application = new Application();
var document = application.Documents.Add();

// Add a combo box content control
object missing = System.Reflection.Missing.Value;
var cc = document.ContentControls.Add(WdContentControlType.wdContentControlComboBox, ref missing);
cc.Title = "Choose an option";
cc.DropdownListEntries.Add("Option 1", "1");
cc.DropdownListEntries.Add("Option 2", "2");

7.2.2 메일 병합

메일 병합 프로세스를 자동화하여 스프레드시트나 데이터베이스 같은 데이터 소스와 Word 문서를 결합하여 개인화된 편지, 라벨 또는 이메일을 대량으로 생성합니다. 이 기능은 대량의 커스터마이즈된 의사소통이나 문서를 생성하는 데 매우 중요합니다.

using Microsoft.Office.Interop.Word;

// Create a new document for mail merge
var mailMergeDoc = application.Documents.Add();

// Open the data source for the mail merge
mailMergeDoc.MailMerge.OpenDataSource("path\\to\\datasource.xlsx");

// Execute the mail merge
mailMergeDoc.MailMerge.Destination = WdMailMergeDestination.wdSendToNewDocument;
mailMergeDoc.MailMerge.Execute(false);

using Microsoft.Office.Interop.Word;

// Create a new document for mail merge
var mailMergeDoc = application.Documents.Add();

// Open the data source for the mail merge
mailMergeDoc.MailMerge.OpenDataSource("path\\to\\datasource.xlsx");

// Execute the mail merge
mailMergeDoc.MailMerge.Destination = WdMailMergeDestination.wdSendToNewDocument;
mailMergeDoc.MailMerge.Execute(false);

7.2.3 수정 추적 및 주석

코드를 통해 Word의 수정 추적 및 주석 기능을 활성화하고 상호작용할 수 있습니다. 이 기능은 공동 편집, 문서 검토 또는 시간 경과에 따른 변경사항 감사를 요구하는 애플리케이션에 필수적입니다.

using Microsoft.Office.Interop.Word;

// Enable track changes
document.TrackRevisions = true;

// Add a comment to the first paragraph
object start = 0;
object end = 0;
Range range = document.Paragraphs[1].Range;
document.Comments.Add(range, "This is a comment.");

using Microsoft.Office.Interop.Word;

// Enable track changes
document.TrackRevisions = true;

// Add a comment to the first paragraph
object start = 0;
object end = 0;
Range range = document.Paragraphs[1].Range;
document.Comments.Add(range, "This is a comment.");

7.2.4 머리글 및 바닥글

페이지 번호, 날짜 또는 사용자 지정 텍스트를 포함하여 머리글 및 바닥글을 동적으로 조작할 수 있습니다. 이는 일관된 브랜드 및 탐색 도움말이 포함된 전문 문서를 작성하는 데 필수적입니다.

using Microsoft.Office.Interop.Word;

// Iterate through sections in the document and set headers and footers
foreach (Section section in document.Sections)
{
    // Set text for primary header
    section.Headers[WdHeaderFooterIndex.wdHeaderFooterPrimary].Range.Text = "Header Text";

    // Add page numbers to primary footer
    section.Footers[WdHeaderFooterIndex.wdHeaderFooterPrimary].PageNumbers.Add();
}

using Microsoft.Office.Interop.Word;

// Iterate through sections in the document and set headers and footers
foreach (Section section in document.Sections)
{
    // Set text for primary header
    section.Headers[WdHeaderFooterIndex.wdHeaderFooterPrimary].Range.Text = "Header Text";

    // Add page numbers to primary footer
    section.Footers[WdHeaderFooterIndex.wdHeaderFooterPrimary].PageNumbers.Add();
}

7.2.5 목차 및 인덱스

문서의 제목 또는 표시된 항목을 기반으로 목차 또는 인덱스를 생성하고 업데이트합니다. 이는 특히 긴 보고서나 책과 같은 탐색 가능한 전문 문서를 작성하는 데 중요합니다.

using Microsoft.Office.Interop.Word;

// Add a table of contents to the document
var toc = document.TablesOfContents.Add(document.Content, UpperHeadingLevel: 1, LowerHeadingLevel: 3, UseHyperlinks: true);

// Add an index to the document
var index = document.Indexes.Add(document.Content);

using Microsoft.Office.Interop.Word;

// Add a table of contents to the document
var toc = document.TablesOfContents.Add(document.Content, UpperHeadingLevel: 1, LowerHeadingLevel: 3, UseHyperlinks: true);

// Add an index to the document
var index = document.Indexes.Add(document.Content);

7.2.6 개체 임베딩 및 연결

Excel 차트 또는 PowerPoint 프레젠테이션과 같은 외부 개체를 Word 문서에 임베드하거나 연결합니다. 이 기능을 통해 소스 파일과 함께 업데이트되는 동적 콘텐츠를 허용하거나 문서 내에 정보를 직접 임베드할 수 있습니다.

using Microsoft.Office.Interop.Word;

// Embed an Excel sheet into the document
object missing = System.Reflection.Missing.Value;
document.InlineShapes.AddOLEObject(
    ClassType: "Excel.Sheet", 
    FileName: "path\\to\\excel.xlsx", 
    LinkToFile: false, 
    DisplayAsIcon: false, 
    IconFileName: ref missing, 
    IconIndex: ref missing, 
    IconLabel: ref missing, 
    Anchor: ref missing
);

using Microsoft.Office.Interop.Word;

// Embed an Excel sheet into the document
object missing = System.Reflection.Missing.Value;
document.InlineShapes.AddOLEObject(
    ClassType: "Excel.Sheet", 
    FileName: "path\\to\\excel.xlsx", 
    LinkToFile: false, 
    DisplayAsIcon: false, 
    IconFileName: ref missing, 
    IconIndex: ref missing, 
    IconLabel: ref missing, 
    Anchor: ref missing
);