1. IronXL
  2. 방법
  3. 테두리 및 정렬
엑셀에서 셀 테두리와 맞춤을 설정하는 방법 | IronXL

IronXL을 사용하여 C#에서 셀 테두리 및 정렬 설정하는 방법

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

IronXL을 사용하여 C# 엑셀 파일에서 MediumDashed와 같은 테두리 유형과 HorizontalAlignment.Center와 같은 정렬 속성을 적용하여 마이크로소프트 Interop 종속성 없이 워크시트 셀에 직접 셀 테두리와 텍스트 정렬을 설정하세요.

엑셀에서는 셀 테두리가 개별 셀이나 셀 그룹에 적용할 수 있는 선 또는 테두리를 나타내며, 텍스트 정렬은 셀 내 텍스트의 수직 및 수평 위치를 의미합니다. IronXL은 이러한 시각적 요소를 정밀하게 프로그래밍으로 제어할 수 있는 엑셀 셀 스타일 작업에 대한 종합적인 API를 제공합니다.

빠른 시작: 한 번의 호출로 셀 테두리 및 텍스트 정렬 중심 설정

단 두 줄로 한 쪽에 테두리 스타일을 적용하고 텍스트를 수평으로 중심에 정렬하세요. Interop 오버헤드 없이 빠르게 시작하세요.

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

    PM > Install-Package IronXl.Excel

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

    workSheet["B2"].Style.LeftBorder.Type = IronXl.Styles.BorderType.MediumDashed;
workSheet["B2"].Style.HorizontalAlignment = IronXl.Styles.HorizontalAlignment.Center;

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

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

    arrow pointer
### 최소 워크플로우(5단계)
  1. 배경 패턴과 색상 설정을 위한 C# 라이브러리 다운로드
  2. 기존 엑셀 스프레드시트를 열거나 새 스프레드시트를 만드세요.
  3. **Type** 속성을 **BorderType**의 사용 가능한 테두리 유형 중 하나로 설정하세요.
  4. 수평 또는 수직 정렬은 **HorizontalAlignment** 및 **VerticalAlignment** 속성을 사용하세요.
  5. 제공되는 색상 유형 또는 16진수 색상 코드를 선택하여 테두리 색상을 설정하세요.


IronXL로 시작하세요.

기본 예제에서 셀 테두리와 텍스트 정렬을 어떻게 설정합니까?

테두리 스타일을 추가하여 선택한 셀, 열, 행 또는 범위의 모양을 사용자 지정할 수 있습니다. 사용되는 속성으로는 TopBorder, RightBorder, BottomBorder 및 LeftBorder가 있습니다. 다양한 스타일 중에서 IronXl.Styles.BorderType 열거형에 있는 것을 선택하세요. 모든 사용 가능한 테두리 유형을 탐색하여 완벽한 매치를 찾으세요.

정확한 텍스트 정렬을 위해 스타일의 HorizontalAlignment 및 VerticalAlignment 속성을 조정하여 원하는 레이아웃을 구현하세요. 원하는 정렬을 설정하려면 IronXl.Styles.HorizontalAlignment 및 IronXl.Styles.VerticalAlignment 열거형을 사용하세요. 데이터를 완벽하게 표현하기 위해 모든 사용 가능한 맞춤 유형을 발견하십시오. 일관된 서식이 필요한 전문 스프레드시트를 만들 때 이 방법이 특히 유용합니다.

테두리와 맞춤을 적용하기 전에 Excel 통합 문서가 제대로 로드되었는지 확인하십시오. 기본 테두리 및 맞춤 설정을 시연하는 완전한 예제는 다음과 같습니다:

:path=/static-assets/excel/content-code-examples/how-to/border-alignment-set-border-alignment.cs
using IronXL;
using IronXL.Styles;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

workSheet["B2"].Value = "B2";

// Set cell border
workSheet["B2"].Style.LeftBorder.Type = BorderType.MediumDashed;
workSheet["B2"].Style.RightBorder.Type = BorderType.MediumDashed;

// Set text alignment
workSheet["B2"].Style.HorizontalAlignment = HorizontalAlignment.Center;

workBook.SaveAs("setBorderAndAlignment.xlsx");
$vbLabelText   $csharpLabel
도트 스타일 테두리가 적용된 B2 셀로 Excel 스타일 그리드에서 테두리 서식 결과를 보여줍니다

어떤 고급 테두리 및 맞춤 옵션이 제공됩니까?

테두리 색상을 어떻게 사용자 정의할 수 있습니까?

기본적으로 테두리 색상은 검정색이나, Color 클래스에 있는 색상 또는 Hex 색상 코드를 사용하여 사용자 지정할 수 있습니다. 테두리 색상을 설정하려면 선택한 색상 또는 Hex 코드를 Color 속성에 사용하세요. 또한, Color 속성을 통해 테두리의 색상을 가져올 수 있습니다. 이러한 유연성은 셀의 배경 색상을 설정하는 것과 유사합니다.

참고해 주세요테두리 유형이 사용 가능한 유형 중 하나로 설정되지 않는 한 테두리 색상만 설정하면 효과가 표시되지 않습니다.

테두리 색상 사용자 정의는 다른 셀 서식 기능과 매끄럽게 작동합니다. 조건부 서식과 결합하면 사용자가 스프레드시트에서 중요한 데이터 패턴을 빠르게 식별할 수 있도록 돕는 동적 시각적 단서를 만들 수 있습니다.

:path=/static-assets/excel/content-code-examples/how-to/border-alignment-set-border-color.cs
using IronXL;
using IronXL.Styles;
using IronSoftware.Drawing;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

workSheet["B2"].Style.LeftBorder.Type = BorderType.Thick;
workSheet["B2"].Style.RightBorder.Type = BorderType.Thick;

// Set cell border color
workSheet["B2"].Style.LeftBorder.SetColor(Color.Aquamarine);
workSheet["B2"].Style.RightBorder.SetColor("#FF7F50");

workBook.SaveAs("setBorderColor.xlsx");
$vbLabelText   $csharpLabel
녹색 왼쪽 테두리가 있는 셀 B2와 주황색 오른쪽 테두리가 있는 셀 C2를 보여주는 스프레드시트로 테두리 색상을 시연합니다

어떤 테두리 선 위치 및 패턴을 적용할 수 있습니까?

총 6개의 테두리 선 위치가 있으며, 각 위치는 다양한 패턴 또는 유형을 제공합니다. 이 위치에는 위쪽, 오른쪽, 아래쪽, 왼쪽, 앞쪽 대각선, 뒤쪽 대각선 및 양쪽 대각선이 포함됩니다. 이 포괄적인 옵션 세트를 사용하면 병합된 셀 작업 시 달성할 수 있는 복잡한 시각적 레이아웃을 더 유연하게 생성할 수 있습니다.

대각선 테두리 작업 시 셀의 내용 및 맞춤 설정과의 상호 작용 방식을 이해하십시오. 대각선 테두리는 Excel 보고서에서 헤더 섹션 또는 시각적 구분자를 만드는 데 특히 유용할 수 있습니다.

:path=/static-assets/excel/content-code-examples/how-to/border-alignment-set-border-line.cs
using IronXL;
using IronXL.Styles;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

workSheet["B2"].StringValue = "Top";
workSheet["B4"].StringValue = "Forward";

// Set top border line
workSheet["B2"].Style.TopBorder.Type = BorderType.Thick;

// Set diagonal border line
workSheet["B4"].Style.DiagonalBorder.Type = BorderType.Thick;
// Set diagonal border direction
workSheet["B4"].Style.DiagonalBorderDirection = DiagonalBorderDirection.Forward;

workBook.SaveAs("borderLines.xlsx");
$vbLabelText   $csharpLabel

보다 복잡한 테두리 시나리오의 경우 여러 셀 또는 범위에 일관된 테두리 스타일을 적용하는 재사용 가능한 함수를 만드는 것을 고려하십시오:

void ApplyUniformBorder(WorkSheet sheet, string range, BorderType borderType, Color borderColor)
{
    var cells = sheet[range];

    // Apply borders to all sides
    cells.Style.TopBorder.Type = borderType;
    cells.Style.RightBorder.Type = borderType;
    cells.Style.BottomBorder.Type = borderType;
    cells.Style.LeftBorder.Type = borderType;

    // Apply color to all borders
    cells.Style.TopBorder.SetColor(borderColor);
    cells.Style.RightBorder.SetColor(borderColor);
    cells.Style.BottomBorder.SetColor(borderColor);
    cells.Style.LeftBorder.SetColor(borderColor);
}

// Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black);
void ApplyUniformBorder(WorkSheet sheet, string range, BorderType borderType, Color borderColor)
{
    var cells = sheet[range];

    // Apply borders to all sides
    cells.Style.TopBorder.Type = borderType;
    cells.Style.RightBorder.Type = borderType;
    cells.Style.BottomBorder.Type = borderType;
    cells.Style.LeftBorder.Type = borderType;

    // Apply color to all borders
    cells.Style.TopBorder.SetColor(borderColor);
    cells.Style.RightBorder.SetColor(borderColor);
    cells.Style.BottomBorder.SetColor(borderColor);
    cells.Style.LeftBorder.SetColor(borderColor);
}

// Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black);
$vbLabelText   $csharpLabel

테두리 선

상단, 오른쪽, 하단, 왼쪽 테두리 및 대각선 방향 없음, 앞으로, 뒤로를 보여주는 Excel 테두리 스타일 데모

테두리 패턴

각기 능동적인 시각적 예제로 제공되는 None부터 SlantedDashDot에 이르는 사용 가능한 셀 테두리 유형을 보여주는 스프레드시트

어떤 텍스트 맞춤 옵션을 지원합니까?

IronXL의 텍스트 맞춤은 셀 내에서 콘텐츠가 배치되는 방식을 포괄적으로 제어합니다. 이 기능은 시각적 일관성이 중요한 다른 형식으로 데이터를 내보낼 때 특히 중요합니다. 맞춤 시스템은 전문적인 외관의 스프레드시트를 만들기 위해 글꼴 스타일링과 같은 다른 서식 기능과 결합하여 작동합니다.

IronXL에서 제공하는 맞춤 옵션의 전체 범위를 아래에서 확인하세요:

가로 및 세로 텍스트 맞춤 옵션을 시각적 예시와 함께 보여주는 Excel 스프레드시트

HorizontalAlignment 열거형

  • General: 일반 정렬된 수평 정렬입니다. 텍스트 데이터는 왼쪽 맞춤입니다. 숫자, 날짜 및 시간은 오른쪽 맞춤입니다. 부울형은 중앙 맞춤입니다. 맞춤 변경은 데이터 유형에 영향을 미치지 않습니다. 특정 맞춤이 설정되지 않았을 때의 기본 맞춤입니다.
  • Left: 오른쪽에서 왼쪽 모드에서도 왼쪽 정렬된 수평 정렬입니다. 셀의 왼쪽 끝에 콘텐츠를 맞춥니다. 들여쓰기 양이 지정되면 셀의 콘텐츠는 지정된 문자 공간 수만큼 왼쪽에서 들여쓰기됩니다.
  • Center: 가운데 정렬된 수평 정렬입니다. 텍스트는 셀을 가로질러 중앙에 배치됩니다. 이는 일반적으로 헤더와 제목에 사용됩니다.
  • Right: 오른쪽 정렬된 수평 정렬입니다. 셀 내용은 우측 정렬 모드에서도 셀의 오른쪽 가장자리에 맞춰 정렬됩니다. 이는 일반적으로 숫자 데이터 표시를 위해 사용됩니다.
  • Fill: 셀 값이 전체 너비에 걸쳐 채워집니다. 오른쪽의 인접 셀도 동일한 채우기 정렬이 되어 있다면, 해당 셀들 역시 채워집니다. 추가 규칙:
    • 부분 값이 아닌 전체 값만 추가될 수 있습니다.
    • 채워진 값을 '최적의 맞춤'으로 열을 넓히지 않습니다.
    • 값의 추가 발생이 셀의 왼쪽/오른쪽 가장자리를 초과하면 추가되지 않습니다.
    • 셀의 표시 값이 채워지며, 기저의 원시 숫자는 아닙니다.
  • Justify: 양쪽 끝 정렬된 수평 정렬입니다. 셀에 텍스트 줄바꿈을 적용하고, 각 줄의 첫 번째 단어는 왼쪽 가장자리에, 마지막 단어는 셀의 오른쪽 가장자리에 맞춰 정렬되도록 합니다(마지막 줄 제외). 이는 특히 문단이 포함된 텍스트가 많은 셀에 유용합니다.
  • CenterSelection: 왼쪽 가장자리 셀의 콘텐츠를 여러 셀에 걸쳐 중앙에 수평으로 정렬합니다. 시각적으로 셀을 병합한 것처럼 보일 수 있으나 실제로 셀을 병합하지는 않습니다. 이 옵션을 사용하면 셀 병합에서 발생할 수 있는 잠재적인 문제를 방지할 수 있습니다.
  • Distributed: 셀 안의 각 줄의 각 '단어'가 셀 너비에 걸쳐 균등하게 분산되며, 왼쪽과 오른쪽 여백은 맞추어져 있습니다. 들여쓰기 값이 적용된다면, 셀의 좌우측 모두 해당 들여쓰기 값만큼 패딩됩니다.

VerticalAlignment 열거형

  • None: 일반적으로 하단 정렬 동작을 결과로 하는 기본 정렬입니다.
  • Top: 셀 상단에 콘텐츠를 정렬합니다. 다양한 내용 높이가 있는 셀에 유용합니다.
  • Center: 셀 안에서 콘텐츠를 수직으로 중앙에 정렬합니다. 이는 특히 수평 중앙 정렬과 결합할 때 균형 잡힌 모양을 만듭니다.
  • Bottom: 셀 하단에 콘텐츠를 정렬합니다. 이는 대부분의 스프레드시트 응용 프로그램에서 기본 행동입니다.
  • Justify: 셀의 높이에 걸쳐 텍스트 줄을 균등하게 배분하며, 위쪽과 아래쪽 여백은 맞추어져 있습니다. 텍스트를 감싸고 줄 간의 간격을 조정하여 전체 행의 높이를 차지하는 수평 맞춤 분배와 유사하게 작동합니다.
  • Distributed: 셀의 높이에 걸쳐 각 줄의 각 '단어'를 균등하게 배분하며, 수평 텍스트 방향에서 위쪽과 아래쪽 여백은 맞추어져 있습니다. 수직 텍스트 방향에서는, 상단에서 하단까지 텍스트 줄을 균등하게 분배하는 수평 분배 정렬과 동일하게 작동합니다.

정렬 설정을 작업할 때, 다른 셀 속성과의 상호 작용을 고려하십시오. 예를 들어, 행과 열의 자동 크기 조절을 할 때, 정렬 설정은 자동으로 크기 조절된 셀 안에 콘텐츠가 맞는 방식에 영향을 미칩니다. 마찬가지로, 수식 작업을 할 때, 적절한 정렬은 스프레드시트 계산을 더 읽기 쉽게 하고 전문적으로 만듭니다.

자주 묻는 질문

Microsoft Office 없이 C#에서 Excel 셀에 테두리를 추가하는 방법은 무엇인가요?

IronXL의 스타일 API를 사용하면 Excel 셀에 테두리를 추가할 수 있습니다. 셀의 Style 속성에 접근하여 LeftBorder.Type, RightBorder.Type, TopBorder.Type, BottomBorder.Type과 같은 속성을 사용하여 MediumDashed와 같은 테두리 유형을 설정하기만 하면 됩니다. IronXL은 Microsoft Office 또는 Interop 종속성 없이 독립적으로 작동합니다.

C#에서 Excel 셀에 사용할 수 있는 테두리 스타일에는 어떤 것들이 있나요?

IronXL은 IronXl.Styles.BorderType 열거형을 통해 MediumDashed, Thin, Thick, Double 등 다양한 테두리 스타일을 제공합니다. 이러한 스타일을 셀의 어느 면(위, 오른쪽, 아래, 왼쪽)에든 적용하여 전문가 수준의 스프레드시트를 만들 수 있습니다.

엑셀 셀의 텍스트를 프로그램적으로 가운데 정렬하려면 어떻게 해야 할까요?

IronXL을 사용하여 Excel 셀의 텍스트를 가운데 정렬하려면 Style.HorizontalAlignment 속성을 IronXl.Styles.HorizontalAlignment.Center로 설정하십시오. 세로 정렬을 제어하려면 VerticalAlignment 속성을 사용하여 텍스트 위치를 완벽하게 조정할 수도 있습니다.

여러 셀에 한 번에 테두리와 정렬을 적용할 수 있나요?

네, IronXL을 사용하면 전체 범위, 열 또는 행에 테두리와 맞춤을 적용할 수 있습니다. 원하는 범위를 선택하고 스타일 속성을 적용하면 여러 셀을 동시에 서식 지정할 수 있어 일괄 서식 작업을 효율적으로 수행할 수 있습니다.

C#에서 Excel 셀의 테두리 색상을 설정하는 방법은 무엇인가요?

IronXL을 사용하면 미리 정의된 색상 유형 또는 사용자 지정 16진수 색상 코드를 사용하여 테두리 색상을 설정할 수 있습니다. Style 객체를 통해 테두리 색상 속성에 접근하여 셀 테두리의 모양을 사용자 지정할 수 있습니다.

테두리를 추가하고 텍스트를 가운데 정렬하는 데 필요한 최소한의 코드는 무엇인가요?

IronXL을 사용하면 단 두 줄의 코드로 테두리를 추가하고 텍스트를 가운데 정렬할 수 있습니다. `workSheet["B2"].Style.LeftBorder.Type = IronXl.Styles.BorderType.MediumDashed;` 및 `workSheet["B2"].Style.HorizontalAlignment = IronXl.Styles.HorizontalAlignment.Center;` 이렇게 하면 Interop 오버헤드 없이 빠르게 서식을 지정할 수 있습니다.

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

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

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

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

시작할 준비 되셨나요?
Nuget 다운로드 1,890,100 | 버전: 2026.3 방금 출시되었습니다

이 페이지에서

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

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

빠른 증거를 원하시나요? PM > Install-Package IronXl.Excel
샘플을 실행하세요 데이터가 스프레드시트로 변환되는 것을 지켜보세요.