1. IronXL
  2. 방법
  3. 셀 데이터 서식 설정
엑셀에서 셀 데이터 서식을 설정하는 방법

IronXL을 사용하여 C#에서 셀 데이터 형식을 설정하는 방법

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

IronXL은 통화, 백분율, 날짜 및 사용자 정의 숫자 형식과 같은 기본 제공 데이터 형식을 사용하여 Excel 셀을 서식화할 수 있게 하며 Interop 종속성 없이 셀 또는 범위에서 FormatString 속성을 설정하여 가능합니다.

빠른 시작: 한 줄에 기본 제공 서식을 단일 셀에 적용하기

이 예제는 IronXL의 API를 사용하여 새 Excel 통합 문서를 만들고 특정 셀에 기본 제공 서식을 적용하는 방법을 보여줍니다. Interop 종속성이 필요 없습니다 — 단지 FormatString을 설정하고 저장하면 됩니다.

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

    PM > Install-Package IronXl.Excel

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

    IronXl.WorkBook book = IronXl.WorkBook.Create(); book.DefaultWorkSheet["B2"].FormatString = IronXl.Formatting.BuiltinFormats.Currency2;

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

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

    arrow pointer
### 최소 워크플로우(5단계)
  1. 데이터 형식을 설정하려면 C# 라이브러리를 다운로드하세요.
  2. 기존 엑셀 스프레드시트를 열거나 새 스프레드시트를 만드세요.
  3. 셀, 열, 행 또는 범위의 **`FormatString`** 속성을 원하는 데이터 형식으로 설정합니다.
  4. **`BuiltinFormats`** 클래스에서 제공하는 내장 데이터 형식을 사용하세요.
  5. 편집한 스프레드시트를 다양한 파일 형식으로 내보내기


엑셀에서 셀 데이터 서식을 설정하는 방법은 무엇인가요?

FormatString 속성은 셀과 범위 모두에서 액세스할 수 있습니다. 따라서 개별 셀, 열, 행 및 선택한 범위에 대해 데이터 형식을 설정할 수 있습니다. 이러한 유연성 덕분에 IronXL은 Interop 없이 C#에서 Excel 파일을 다뤄야 할 때 특히 강력한 도구입니다.

데이터 서식 지정은 스프레드시트에서 정보를 명확하게 표시하는 데 필수적입니다. 통화 가치를 포함한 재무 보고서를 작성하든, 정확한 소수점 자리가 필요한 과학 데이터를 작성하든, 날짜 기반 분석을 하든, 적절한 서식을 사용하면 데이터를 읽기 쉽고 전문적으로 보여줄 수 있습니다. IronXL은 직관적인 API를 통해 Excel의 서식 엔진에 직접 접근할 수 있도록 하여 이 과정을 간소화합니다.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format.cs
using IronXL;
using IronXL.Formatting;
using System;
using System.Linq;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the data format to 12300.00%
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Percent2;

// Set the data format to 123.0000
workSheet["A2"].Value = 123;
workSheet["A2"].FormatString = "0.0000";

// Set data display format to range
DateTime dateValue = new DateTime(2020, 1, 1, 12, 12, 12);
workSheet["A3"].Value = dateValue;
workSheet["A4"].Value = new DateTime(2022, 3, 3, 10, 10, 10);
workSheet["A5"].Value = new DateTime(2021, 2, 2, 11, 11, 11);

IronXL.Range range = workSheet["A3:A5"];

// Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss";

workBook.SaveAs("dataFormats.xlsx");
$vbLabelText   $csharpLabel
서식이 지정된 셀을 보여주는 Excel 스프레드시트: 백분율, 숫자 및 날짜/시간 값이 다양한 표시 형식으로 표시됩니다.

변환 없이 셀 값을 문자열로 설정하려면 어떻게 해야 하나요?

IronXL에서 값을 설정할 때 자동 변환 없이 셀에 정확한 값을 직접 할당하기 위해 Value 대신 StringValue을 사용하세요. 이는 엑셀에서 셀 값 앞에 작은따옴표(')를 붙이는 것과 같은 효과를 냅니다. 이 기술은 제품 코드, 전화번호 또는 텍스트 형태로 유지되어야 하는 기타 데이터를 다룰 때 특히 유용합니다. 보다 고급 문자열 조작에 대해서는 .NET에서 Excel 값을 작성하는 방법을 참조하세요.

:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-stringvalue.cs
// Assign value as string
workSheet["A1"].StringValue = "4402-12";
$vbLabelText   $csharpLabel

IronXL에서 내장 형식을 사용하는 방법은 무엇인가요?

IronXL 라이브러리는 Excel 셀 서식을 지정하기 위해 IronXl.Formatting.BuiltinFormats 클래스를 통해 액세스할 수 있는 다양한 미리 정의된 형식 문자열을 제공합니다. 이 기능을 사용하면 엑셀 스프레드시트에서 데이터가 표시되는 방식을 사용자 지정할 수 있습니다. 이러한 내장 형식은 가장 일반적인 비즈니스 시나리오를 포괄하며 모든 Excel 버전과 호환됩니다.

프로그램을 사용하여 스프레드시트를 작성할 때, 문서 전체에 걸쳐 전문적인 수준을 유지하려면 일관된 서식을 적용하는 것이 매우 중요합니다. BuiltinFormats 클래스는 Excel의 표준 서식 옵션과 일치하는 30개 이상의 사전 구성된 형식 패턴을 제공합니다.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-builtin-formats.cs
using IronXL;
using IronXL.Formatting;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Use builtin formats
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Accounting0;

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

지원되는 내장 데이터 형식에는 어떤 것들이 있습니까?

Duration 유형의 경우 입력 값은 일 단위로 표현됩니다. 예를 들어, 1일은 24시간이고, 1.05일은 25시간 12분입니다. 이 기능은 시간 추적이나 프로젝트 관리와 관련된 엑셀 데이터를 다룰 때 특히 유용합니다. 사용 가능한 형식 유형은 다음과 같습니다.

다양한 데이터 유형에 대한 입력 값과 서식이 지정된 출력 값을 보여주는 Excel 스프레드시트

각 형식 유형은 어떤 역할을 하나요?

  • General: 특정 서식 없이 숫자를 기본 형식으로 표시합니다.
  • Duration1: "mm:ss"와 같이 분과 초로 기간을 표시합니다.
  • Duration2: "[h]:mm:ss"와 같이 시간, 분, 초로 기간을 표시합니다.
  • Duration3: "mm:ss.0"과 같이 분과 초 및 밀리초로 기간을 표시합니다.
  • Accounting0: 소수점 없이 괄호로 부정 수치를 표시하는 회계 형식입니다. "#,##0_);(#,##0)."
  • Accounting0Red: 소수점 없이 빨간색으로 부정 수치를 표시하는 회계 형식입니다. "#,##0_);Red."
  • Accounting2: 소수점 두 자리와 괄호로 부정 수치를 표시하는 회계 형식입니다. "#,##0.00;(#,##0.00)."
  • Accounting2Red: 소수점 두 자리와 빨간색으로 부정 수치를 표시하는 회계 형식입니다. "#,##0.00_);Red."
  • Time1: AM/PM을 사용하는 12시간 형식입니다. "h:mm AM/PM."
  • Time2: 초와 AM/PM을 포함한 12시간 형식입니다. "h:mm:ss AM/PM."
  • Time3: 초가 없는 24시간 형식입니다. "h:mm."
  • Time4: 초를 포함한 24시간 형식입니다. "h:mm:ss."
  • ShortDate: "m/d/yy"와 같은 짧은 날짜 형식입니다.
  • ShortDateAndTime: "m/d/yy h:mm"와 같은 짧은 날짜 및 시간 형식입니다.
  • LongDate1: "d-mmm-yy"와 같은 월, 일, 연도를 포함한 긴 날짜 형식입니다.
  • LongDate2: "d-mmm"와 같은 일과 월 약자를 포함한 긴 날짜 형식입니다.
  • LongDate3: "mmm-yy"와 같은 월 약자와 연도를 포함한 긴 날짜 형식입니다.
  • Fraction1: "# ?/?"와 같은 한 자리 소수 분수 형식입니다.
  • Fraction2: "# ??/??"와 같은 두 자리 소수 분수 형식입니다.
  • Scientific1: "##0.0E+0"와 같은 소수점 한 자리 과학적 표기법입니다.
  • Scientific2: "0.00E+00"와 같은 소수점 두 자리 과학적 표기법입니다.
  • Percent: 소수점 없는 백분율 형태입니다. "0%"
  • Percent2: 소수점 두 자리 백분율 형태입니다. "0.00%"
  • Currency0: 음수를 괄호로 감싼 상태로 소수점 없는 통화 형식입니다. "$#,##0_);($#,##0)."
  • Currency0Red: 음수를 빨간색으로 표시한 소수점 없는 통화 형식입니다. "$#,##0_);Red."
  • Currency2: 소수점 두 자리와 음수를 괄호로 표시한 통화 형식입니다. "$#,##0.00;($#,##0.00)."
  • Currency2Red: 소수점 두 자리와 음수를 빨간색으로 표시한 통화 형식입니다. "$#,##0.00_);Red."
  • Thousands0: 천 단위 구분자와 소수점이 없는 숫자 형식입니다. "#,##0"
  • Thousands2: 천 단위 구분자와 소수점 두 자리 숫자 형식입니다. "#,##0.00"
  • Number0: 소수점이 없는 숫자 형식입니다. "0"
  • Number2: 소수점 두 자리 숫자 형식입니다. "0.00"
  • Text: 기본 텍스트 형식입니다. "@"

엑셀의 데이터 서식 및 숫자 서식은 숫자, 날짜, 시간 및 기타 데이터가 셀에 표시되는 방식을 제어하여 가독성을 높이고 데이터 정확성을 보장합니다. 데이터 형식을 사용하면 백분율이나 통화와 같은 특정 형식으로 정보를 표시할 수 있습니다. 마찬가지로 숫자 형식을 사용하면 소수점 자릿수와 표시 옵션을 사용자 지정할 수 있습니다.

서로 다른 범위에 여러 서식을 적용하려면 어떻게 해야 하나요?

실제 응용 프로그램에서는 스프레드시트의 여러 부분에 서로 다른 서식을 적용해야 하는 경우가 많습니다. 이 예제는 여러 데이터 형식을 사용하여 재무 보고서를 서식 지정하는 방법을 보여줍니다. 이 접근 방식은 C#에서 데이터베이스 또는 기타 데이터 소스에서 Excel로 내보낼 때 특히 유용합니다.

using IronXL;
using IronXl.Formatting;
using System;

// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;

// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;

// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;

// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;

// Apply accounting format to expense columns
IronXl.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;

// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");
using IronXL;
using IronXl.Formatting;
using System;

// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;

// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;

// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;

// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;

// Apply accounting format to expense columns
IronXl.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;

// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");
$vbLabelText   $csharpLabel

이 예시는 다양한 형식 유형이 결합되어 전문적인 재무 문서를 만드는 방법을 보여줍니다. 조건부 서식을 포함한 더욱 고급 서식 옵션을 사용하려면 이러한 개념을 더욱 확장할 수 있습니다.

대규모 데이터 세트를 다루거나 프로그램을 사용하여 보고서를 생성할 때 일관된 서식이 매우 중요해집니다. IronXL의 서식 시스템은 수학 함수 및 수식 편집 과 같은 다른 기능과 완벽하게 통합되어 완전 자동화된 보고 솔루션을 만들 수 있습니다.

Office Interop에서 IronXL로 마이그레이션하거나 더 나은 성능을 원하는 개발자에게 IronXL의 서식 시스템은 상당한 이점을 제공합니다. 기존 방식과 달리 COM 상호 운용성 오버헤드 없이 수천 개의 셀을 효율적으로 서식 지정할 수 있습니다. Excel 자동화 모범 사례에 대해 자세히 알아보려면 당사의 종합적인 Excel 문서를 참조하십시오.

자주 묻는 질문

Interop을 사용하지 않고 C#에서 Excel 셀의 서식을 지정하는 방법은 무엇인가요?

IronXL은 상호 운용성 종속성 없이 Excel 셀 서식을 지정하는 간단한 방법을 제공합니다. 셀 또는 범위의 FormatString 속성을 사용하여 통화, 백분율, 날짜 및 사용자 지정 숫자 서식과 같은 기본 제공 서식을 적용할 수 있습니다. IronXL을 사용하여 통합 문서를 만들거나 열고 FormatString 속성을 원하는 서식으로 설정하기만 하면 됩니다.

셀에 통화 서식을 적용하는 가장 빠른 방법은 무엇입니까?

IronXL을 사용하면 단 한 줄의 코드로 통화 서식을 적용할 수 있습니다. 통합 문서를 만든 후 다음 코드를 사용하면 됩니다. book.DefaultWorkSheet["B2"].FormatString = IronXl.Formatting.BuiltinFormats.Currency2; 이 코드는 B2 셀에 소수점 둘째 자리까지 표시되는 기본 제공 통화 서식을 적용합니다.

여러 셀을 한 번에 서식 지정할 수 있나요?

네, IronXL은 FormatString 속성을 통해 개별 셀, 전체 열, 행 또는 선택한 범위를 서식 지정할 수 있도록 지원합니다. 이러한 유연성 덕분에 Excel 스프레드시트의 여러 셀에 일관된 서식을 적용하는 것이 각 셀을 개별적으로 수정하지 않고도 간편하게 가능합니다.

셀 값을 설정할 때 자동 데이터 변환을 방지하려면 어떻게 해야 하나요?

IronXL은 셀 값을 자동 변환 없이 문자열로 설정할 수 있는 StringValue 속성을 제공합니다. Value 속성 대신 StringValue를 사용하면 셀에 정확한 값을 할당할 수 있습니다. 이는 Excel에서 셀 값 앞에 작은따옴표(')를 붙이는 것과 유사하게 작동하며, 제품 코드, 전화번호 또는 텍스트로 유지해야 하는 기타 데이터에 특히 유용합니다.

사용 가능한 내장 포맷 옵션에는 어떤 것들이 있습니까?

IronXL은 IronXl.Formatting.BuiltinFormats 클래스를 통해 다양한 통화 형식, 날짜 및 시간 형식, 백분율 표시, 과학적 표기법, 사용자 지정 숫자 형식 등 미리 정의된 다양한 형식 문자열을 제공하여 Excel 스프레드시트에서 데이터 표시 방식을 원하는 대로 설정할 수 있도록 지원합니다.

셀 서식 기능을 사용하려면 Microsoft Excel을 설치해야 하나요?

아니요, IronXL은 Microsoft Excel이나 Interop 종속성 없이 독립적으로 작동합니다. 이 라이브러리에는 Excel 파일을 직접 처리하는 자체 서식 엔진이 포함되어 있어 Excel이 설치되지 않은 서버 환경이나 시스템에 적합합니다.

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

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, 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
샘플을 실행하세요 데이터가 스프레드시트로 변환되는 것을 지켜보세요.