소개

Aspose.Cells FOSS for .NET은 Microsoft Office에 의존하지 않고 Excel .xlsx 워크북을 읽고, 쓰고, 조작할 수 있는 순수 관리 코드이며 MIT 라이선스 라이브러리입니다. Aspose.Cells_FOSS NuGet 패키지로 설치되며, 콘솔 앱, 웹 API, 백그라운드 워커, 서버리스 함수 등 모든 .NET 프로젝트에 통합됩니다.

이 게시물은 공개 API에 대한 기능별 walkthrough를 제공하여, 무엇을 할 수 있는지와 C# 코드에서 각 기능을 어떻게 호출하는지 보여줍니다.


기능 개요

워크북 및 워크시트 수명 주기

모든 작업의 진입점은 Workbook 클래스입니다. new Workbook()을 사용해 새로 생성하거나, new Workbook(filePath) 또는 new Workbook(stream)를 사용해 기존 .xlsx를 로드합니다. Workbook.Worksheets를 통해 시트를 탐색하고, Worksheet.Name와 Worksheet.VisibilityType을 설정하며, Workbook.Save()로 저장합니다. 손상된 파일의 경우, TryRepairPackage = true와 TryRepairXml = true을 포함한 LoadOptions 인스턴스를 전달합니다.

using Aspose.Cells_FOSS;

var options = new LoadOptions
{
    TryRepairPackage = true,
    TryRepairXml = true,
};

try
{
    _ = new Workbook("sample.xlsx", options);
}
catch (WorkbookLoadException exception)
{
    Console.WriteLine(exception.Message);
}

셀 데이터 및 수식

셀에 값을 쓰려면 Cell.PutValue()을(를) 사용합니다 — 오버로드는 string, int, double, decimal, bool, DateTime을(를) 허용합니다. 값을 다시 읽어오려면 Cell.Value, Cell.StringValue, Cell.Formula을(를) 사용합니다. Cell.Formula 속성으로 Excel 수식을 설정합니다; 수식 문자열은 저장 시 보존되며 다시 로드해도 유지됩니다.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].Formula = "=B1*2";

workbook.Save("hello.xlsx");

var loaded = new Workbook("hello.xlsx");
Console.WriteLine(loaded.Worksheets[0].Cells["C1"].Formula);
Console.WriteLine(loaded.Worksheets[0].Cells["C1"].StringValue);

셀 스타일링

Style 객체를 적용하여 글꼴, 채우기, 테두리, 숫자 형식 및 정렬을 제어합니다. 현재 스타일은 Cell.GetStyle()으로 가져와 수정한 뒤 Cell.SetStyle()로 커밋합니다. 배경 채우기의 경우 Style.Pattern = FillPattern.Solid을 설정하고 Color를 Style.ForegroundColor에 할당합니다. 셀 범위를 확장하려면 Cells.Merge()을 사용합니다.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var cell = workbook.Worksheets[0].Cells["A1"];
cell.PutValue("Styled");

var style = cell.GetStyle();
style.Font.Bold = true;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 241, 196, 15);
cell.SetStyle(style);

Console.WriteLine($"{cell.StringValue} / Bold={cell.GetStyle().Font.Bold}");

조건부 서식

ConditionalFormattingCollection를 통해 셀 범위에 조건부 서식 규칙을 연결합니다. 규칙은 FormatConditionType.CellValue, Expression, ColorScale, DataBar, IconSet를 지원합니다. 비교 연산자(Between, Equal, GreaterThan 등)를 지정하려면 OperatorType을 사용하고, 일치하는 셀에 Style을 할당하며, 규칙별로 우선순위와 true일 경우 중단 동작을 설정합니다.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];

var cfCollection = sheet.ConditionalFormattings[sheet.ConditionalFormattings.Add()];
cfCollection.AddArea(CellArea.CreateCellArea("A1", "A10"));
var rule = cfCollection[cfCollection.AddCondition(
    FormatConditionType.CellValue, OperatorType.Between, "3", "7")];
var style = rule.Style;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 255, 199, 206);
style.Font.Bold = true;
rule.Style = style;

workbook.Save("conditional-formatting.xlsx");

데이터 유효성 검사

Worksheet.Validations을 사용하여 셀에 입력 제약을 추가합니다. 지원되는 유효성 검사 유형에는 ValidationType.List, Decimal, Custom 등이 포함됩니다. 입력 프롬프트(InputTitle, InputMessage)와 오류 메시지(ErrorTitle, ErrorMessage, ValidationAlertType)를 구성합니다. 검증 범위를 정의하려면 CellArea.CreateCellArea()을 사용하고, 추가 범위에 규칙을 적용하려면 Validation.AddArea()을 사용합니다.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Validation Sheet";

var listIdx = sheet.Validations.Add(CellArea.CreateCellArea("A1", "A3"));
var listVal = sheet.Validations[listIdx];
listVal.Type = ValidationType.List;
listVal.Formula1 = "\"Open,Closed\"";
listVal.IgnoreBlank = true;
listVal.InCellDropDown = true;
listVal.ShowInput = true;
listVal.InputTitle = "Status";
listVal.InputMessage = "Pick a status";
listVal.ShowError = true;
listVal.ErrorTitle = "Invalid";
listVal.ErrorMessage = "Choose from the list";

workbook.Save("validations-sample.xlsx");

페이지 설정 및 인쇄 옵션

Print 레이아웃을 Worksheet.PageSetup을(를) 통해 구성합니다. 여백(LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, 배율, 인쇄 영역, 제목 행 및 열, 머리글 및 바닥글, 페이지 나누기를 설정합니다. 모든 설정은 저장-로드 라운드 트립을 통해 유지됩니다.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Print Sheet";
sheet.Cells["A1"].PutValue("Title");

var pageSetup = sheet.PageSetup;
pageSetup.Orientation = PageOrientationType.Landscape;
pageSetup.PaperSize = PaperSizeType.PaperA4;
pageSetup.PrintArea = "$A$1:$C$10";
pageSetup.PrintTitleRows = "$1:$2";
pageSetup.LeftHeader = "Left Header";
pageSetup.CenterFooter = "Center Footer";
pageSetup.PrintGridlines = true;
pageSetup.CenterHorizontally = true;

workbook.Save("page-setup-sample.xlsx");

워크시트 설정 및 보호

시트별 표시를 Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom, TabColor 로 제어합니다. Worksheet.Protect() 으로 시트를 보호하고, 세분화된 Protection 플래그(Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells) 를 구성합니다. 행 높이, 열 너비, 숨긴 행/열 및 병합 영역은 Cells.Rows, Cells.Columns, Cells.Merge() 를 통해 관리합니다.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var layout = workbook.Worksheets[0];
layout.Name = "Layout";
layout.VisibilityType = VisibilityType.Hidden;
layout.TabColor = Color.FromArgb(255, 34, 68, 102);
layout.ShowGridlines = false;
layout.Zoom = 85;
layout.Protect();
layout.Protection.FormatCells = true;
layout.Protection.InsertRows = true;

layout.Cells["A1"].PutValue("Merged");
layout.Cells.Rows[1].Height = 22.5d;
layout.Cells.Columns[0].Width = 18.25d;
layout.Cells.Merge(0, 0, 2, 2);

workbook.Save("worksheet-settings-sample.xlsx");

하이퍼링크 및 이름이 지정된 범위

외부, 내부 및 mailto: 하이퍼링크를 HyperlinkCollection.Add() 로 추가합니다. 사용자에게 표시되는 레이블을 위해 Hyperlink.TextToDisplay와 Hyperlink.ScreenTip을 설정합니다. DefinedNameCollection.Add() 를 사용해 통합문서 또는 시트 범위에서 이름이 지정된 범위를 정의합니다 — 이름이 지정된 범위는 파일 재로드 후에도 유지되는 안정적인 수식 기준점 및 차트 데이터 소스로 작동합니다.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];

sheet.Cells["A1"].PutValue("Docs");
var link = sheet.Hyperlinks[sheet.Hyperlinks.Add("A1", 1, 1, "https://example.com/docs")];
link.TextToDisplay = "Docs";
link.ScreenTip = "External documentation";

var name = workbook.DefinedNames[workbook.DefinedNames.Add("PrimaryRange", "='Sheet1'!$A$1:$D$5")];
name.Comment = "Primary data range";

workbook.Save("hyperlinks-names.xlsx");
Console.WriteLine("Hyperlinks: " + sheet.Hyperlinks.Count);
Console.WriteLine("Defined names: " + workbook.DefinedNames.Count);

빠른 시작

dotnet add package Aspose.Cells.FOSS
using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].Formula = "=B1*2";
workbook.Save("output.xlsx");

지원되는 형식

형식확장자읽기쓰기
Xlsx.xlsx✓✓
Auto(다양함)✓—

오픈 소스 및 라이선스

Aspose.Cells FOSS for .NET은 MIT 라이선스 하에 공개되며 NuGet을 통해 Aspose.Cells_FOSS으로 배포됩니다. 오픈 소스 및 상업 프로젝트 모두에 적합합니다.


시작하기

관련 리소스