C#에서 Excel 파일을 여는 방법

IronXL의 주요 기능은 무엇인가요?

• 워크북 로드를 사용하여 XLS/XLSX/CSV/TSV 형식으로 데이터를 열고, 읽고, 검색합니다.
• 여러 형식으로 Excel 워크시트 내보내기를 저장 & 내보내기와 함께 수행합니다.
• 암호를 사용하여 파일을 암호화하고 해독하여 보안 기능을 제공합니다.
• DataSet 통합을 통해 Excel 시트를 DataSet 및 DataTable 객체로 작업할 수 있습니다.
• Excel 수식은 자동으로 재계산되며, 수학 함수를 지원합니다.
• WorkSheet["A1:B10"]과 같은 직관적인 범위 구문으로 스프레드시트 데이터를 편집합니다.
• 셀 범위 정렬, 열 및 행 정렬.
• 글꼴, 배경, 테두리, 정렬, 그리고 숫자 형식으로 셀을 스타일링합니다.

시작하기 전에 무엇이 필요하나요?

C# 애플리케이션에서 IronXL을 사용하려면, 로컬 컴퓨터에 다음 구성 요소를 설치하세요:

1. Visual Studio - C# .NET 애플리케이션을 개발하기 위한 공식 IDE. Microsoft 웹사이트에서 Visual Studio를 다운로드하여 설치할 수 있습니다. JetBrains ReSharper & Rider도 사용할 수 있습니다. 시작 개요를 참조하여 추가 설정 지침을 확인하세요.
2. IronXL - C#에서 Excel 시트 작업을 돕는 Excel 라이브러리. 사용하기 전에 C# 애플리케이션에 설치되어야 합니다. NuGet 웹사이트나 Visual Studio의 NuGet 패키지 관리를 통해 다운로드할 수 있습니다. .NET Excel DLL 파일을 직접 다운로드할 수도 있습니다. 라이센스 구현에 대해서는 라이센스 키 사용을 참조하세요.

어떤 네임스페이스를 가져와야 하나요?

Visual Studio와 IronXL 설치가 완료되면, 다음 줄을 C# 파일의 맨 위에 추가하여 필요한 IronXL 네임스페이스를 추가하세요:

// Add reference to the IronXL library
using IronXL;

// Add reference to the IronXL library
using IronXL;

특정 Excel 형식이나 고급 기능을 작업할 때는 다음도 필요할 수 있습니다:

using IronXl.Formatting;  // For cell styling
using IronXl.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

using IronXl.Formatting;  // For cell styling
using IronXl.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

기존 Excel 파일을 로드하는 방법은?

Excel 파일은 워크북이라고도 하며, 각 워크시트에는 셀 값이 포함된 여러 워크시트로 구성됩니다. Excel 파일을 열고 읽기 위해, WorkBook 클래스의 Load 메서드를 사용하여 로드하세요. 워크북 로드 기능은 다양한 형식을 지원합니다.

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

이는 WorkBook 인스턴스로 워크북을 초기화합니다. 특정 WorkSheet을 열려면, WorkSheets 컬렉션에서 가져옵니다. 워크시트 관리 가이드는 워크시트 작업에 대한 자세한 정보를 제공합니다:

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

이는 Excel 파일의 첫 번째 시트를 읽고 쓰기 준비가 되어 있는 상태로 액세스합니다.

Excel 파일

Excel 셀에서 데이터를 어떻게 읽나요?

Excel 파일이 열리면, 데이터 읽기에 준비가 됩니다. C#에서 IronXL을 사용하여 Excel 파일에서 데이터를 읽는 것은 간단합니다. 셀 범위를 지정하여 셀 값을 읽을 수 있으며, 범위 선택 기능을 사용합니다.

다음 코드는 셀의 값을 가져옵니다:

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

출력 결과는 다음과 같습니다.

Excel 읽기

셀의 범위에서 데이터를 읽으려면, 지정된 범위를 반복하여 탐색하는 루프를 사용합니다. Excel 범위 선택 예시에서 더 많은 패턴을 제공합니다:

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

셀 범위 A2:A6의 각 값은 접근되어 콘솔에 출력됩니다.

셀 범위 읽기

더 자세한 읽기 및 쓰기 예시를 위해 C#에서 Excel 읽기 튜토리얼을 확인하세요. Excel 데이터를 DataTables로 변환하여 더 쉽게 조작할 수 있습니다:

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

새 Excel 파일을 어떻게 생성하나요?

IronXL은 또한 데이터 저장 및 검색을 위한 새 워크북 생성을 지원합니다. 스프레드시트 생성 가이드에서는 포괄적인 예시를 제공합니다.

한 줄의 코드로 새 Excel 파일을 생성할 수 있습니다:

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

다음으로, 워크시트를 생성하고 데이터를 추가하세요. 더 고급 생성 패턴은 새 Excel 파일 생성을 참조하세요.

워크북에 워크시트를 어떻게 추가하나요?

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

이 코드는 워크북에 "GDPByCountry"라는 이름의 워크시트를 추가하여 셀 값을 추가할 수 있게 합니다. 워크시트 관리 및 워크시트 복사에 대해 더 알아보세요.

특정 셀에 값을 설정하려면 아래 코드를 사용하세요:

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

최종 출력은 다음과 같습니다:

셀에 값 추가

다양한 Excel 형식 작업

IronXL은 여러 Excel 형식을 지원합니다. 다른 파일 유형을 처리하는 방법은 다음과 같습니다:

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

스프레드시트 파일 형식 변환 및 XLSX를 CSV, JSON, XML로 변환에 대해 알아보세요.

오류 처리 및 모범 사례

Excel 파일 작업 시, 적절한 오류 처리를 구현하세요:

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

프로덕션 응용 프로그램에서는 로깅 설정 및 적절한 오류 처리 패턴 구현을 고려하세요.