IronWord 사용하여 C#으로 DOCX 파일에 표를 추가하는 방법

워드 문서에 표를 추가하는 방법은 무엇인가요?

표는 워드 문서의 기본 구성 요소입니다. 먼저, 행과 열의 수를 제공하여 Table 클래스를 인스턴스화하십시오. 배경색, 음영, 테두리, 줄무늬, 너비 등 테이블의 스타일을 구성하세요. 두 번째로, 직관적인 [row, column] 인덱싱을 사용하여 각 셀에 접근하십시오. 각 셀에 텍스트, 이미지, 도형, 단락 또는 표를 추가할 수 있습니다. 마지막으로, 표를 워드 문서에 추가하세요.

IronWord 의 표는 Word 문서에서 구조화된 데이터를 구성하기 위한 유연한 기반을 제공합니다. 청구서, 보고서, 데이터 요약을 만들 때, Table 클래스는 콘텐츠와 프레젠테이션에 대한 포괄적인 제어를 제공합니다. 0부터 시작하는 인덱싱 시스템은 프로그램 방식으로 셀을 반복적으로 순회하는 것을 간소화하며, 풍부한 스타일링 옵션은 전문적인 외관을 보장합니다.

:path=/static-assets/word/content-code-examples/how-to/add-table-add-table.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

WordDocument doc = new WordDocument();

// Create table
Table table = new Table(5, 3);

// Configure border style
BorderStyle borderStyle = new BorderStyle();
borderStyle.BorderColor = Color.Black;
borderStyle.BorderValue = BorderValues.Thick;
borderStyle.BorderSize = 5;

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

// Apply styling
table.Zebra = new ZebraColor("FFFFFF", "dddddd");
table.Borders = tableBorders;

// Populate table
table[0, 0] = new TableCell(new TextContent("Number"));
table[0, 1] = new TableCell(new TextContent("First Name"));
table[0, 2] = new TableCell(new TextContent("Last Name"));
for (int i = 1; i < table.Rows.Count; i++)
{
    table[i, 0].AddChild(new TextContent($"{i}"));
    table[i, 1].AddChild(new TextContent($"---"));
    table[i, 2].AddChild(new TextContent($"---"));
}

// Add table
doc.AddTable(table);

doc.Save("document.docx");

TableCell 클래스의 AddChild 메소드는 단락, 이미지, 도형, 표를 포함하는 ContentElement 객체를 수락합니다. 이를 통해 복잡한 사용 사례를 위해 중첩 테이블을 사용할 수 있습니다.

IronWord 테이블 셀 작업 시 콘텐츠 관리를 위한 다양한 방법을 제공합니다. 생성자를 사용하여 초기 콘텐츠로 TableCell를 인스턴스화하거나 AddChild 메소드를 사용하여 점진적으로 콘텐츠를 추가하십시오. 이러한 유연성을 통해 다양한 콘텐츠 유형을 결합한 복잡한 셀 구조를 구축할 수 있습니다. 예를 들어, 하나의 셀에 제목 단락, 이미지, 그리고 상세 사양을 위한 중첩된 표가 포함될 수 있습니다.

다음은 고급 세포 증식 기술을 보여주는 예입니다.

// Example: Creating cells with mixed content
TableCell complexCell = new TableCell();

// Add a styled paragraph
Paragraph header = new Paragraph();
header.Add(new TextContent("Product Details").Bold().FontSize = 14);
complexCell.AddChild(header);

// Add multiple text elements
complexCell.AddChild(new TextContent("SKU: "));
complexCell.AddChild(new TextContent("PROD-001").Bold());
complexCell.AddChild(new TextContent("\nPrice: $49.99"));

// Cells can also contain lists, images, and more
// This demonstrates the versatility of table cells in IronWord

// Example: Creating cells with mixed content
TableCell complexCell = new TableCell();

// Add a styled paragraph
Paragraph header = new Paragraph();
header.Add(new TextContent("Product Details").Bold().FontSize = 14);
complexCell.AddChild(header);

// Add multiple text elements
complexCell.AddChild(new TextContent("SKU: "));
complexCell.AddChild(new TextContent("PROD-001").Bold());
complexCell.AddChild(new TextContent("\nPrice: $49.99"));

// Cells can also contain lists, images, and more
// This demonstrates the versatility of table cells in IronWord

테이블에 적용할 수 있는 스타일링 옵션은 무엇인가요?

IronWord 표에 대한 광범위한 스타일링 기능을 제공하여 시각적으로 매력적이고 전문적인 문서를 만들 수 있도록 합니다. 기본 테두리와 색상 외에도 셀 여백, 정렬을 제어하고 얼룩말 무늬를 통해 조건부 서식을 적용할 수 있습니다. 이 스타일링 시스템은 친숙한 속성 이름과 명확한 값 열거형을 사용하여 강력한 기능과 직관적인 디자인을 결합합니다.

사용 가능한 테두리 스타일은 무엇인가요?

BorderValues 열거형을 사용하여 경계 값에 대한 모든 옵션을 탐색하십시오:

BorderValues 열거형은 표의 미학에 대한 포괄적인 옵션을 제공합니다. 단순한 단선부터 물결이나 점과 같은 복잡한 패턴에 이르기까지, 각 스타일은 특정한 디자인 목적을 가지고 있습니다. 업무용 문서에는 전문적인 느낌의 이중 또는 삼중 테두리가 적합하며, 창의적인 문서에는 물결무늬 또는 점선 무늬가 활용될 수 있습니다. BorderSize 속성은 BorderValue와 함께 작동하여 라인 두께를 포인트의 8분의 1로 측정하여 정확한 제어를 제공합니다.

다음은 다양한 테두리 구성 방식을 보여주는 실제 사례입니다.

// Example: Applying different borders to table sections
Table styledTable = new Table(4, 4);

// Create distinct border styles for header and body
BorderStyle headerBorder = new BorderStyle
{
    BorderColor = Color.Navy,
    BorderValue = BorderValues.Double,
    BorderSize = 8
};

BorderStyle bodyBorder = new BorderStyle
{
    BorderColor = Color.Gray,
    BorderValue = BorderValues.Dotted,
    BorderSize = 3
};

// Apply different borders to different parts of the table
// This creates visual hierarchy and improves readability
styledTable.Borders = new TableBorders
{
    TopBorder = headerBorder,
    BottomBorder = headerBorder,
    LeftBorder = bodyBorder,
    RightBorder = bodyBorder,
    InsideHorizontalBorder = bodyBorder,
    InsideVerticalBorder = bodyBorder
};

// Zebra striping for better row distinction
styledTable.Zebra = new ZebraColor("F5F5F5", "FFFFFF");

// Example: Applying different borders to table sections
Table styledTable = new Table(4, 4);

// Create distinct border styles for header and body
BorderStyle headerBorder = new BorderStyle
{
    BorderColor = Color.Navy,
    BorderValue = BorderValues.Double,
    BorderSize = 8
};

BorderStyle bodyBorder = new BorderStyle
{
    BorderColor = Color.Gray,
    BorderValue = BorderValues.Dotted,
    BorderSize = 3
};

// Apply different borders to different parts of the table
// This creates visual hierarchy and improves readability
styledTable.Borders = new TableBorders
{
    TopBorder = headerBorder,
    BottomBorder = headerBorder,
    LeftBorder = bodyBorder,
    RightBorder = bodyBorder,
    InsideHorizontalBorder = bodyBorder,
    InsideVerticalBorder = bodyBorder
};

// Zebra striping for better row distinction
styledTable.Zebra = new ZebraColor("F5F5F5", "FFFFFF");

$vbLabelText   $csharpLabel

테이블 너비 및 정렬 속성은 추가적인 레이아웃 제어 기능을 제공합니다. 표의 너비나 비율을 특정 값으로 설정하고, 문서 내에서 표를 정렬하고, 주변 콘텐츠와의 상호 작용을 제어할 수 있습니다. 셀 수준 스타일링 옵션에는 개별 배경색, 텍스트 정렬 및 여백 조정이 포함되어 테이블 모양의 모든 측면을 세밀하게 제어할 수 있습니다.

이러한 스타일링 옵션을 사용하면 간단한 데이터 표부터 여러 시각적 계층 구조를 가진 복잡한 재무제표에 이르기까지 모든 문서의 디자인 요구 사항에 맞는 표를 만들 수 있습니다.