C#에서 Excel 범위를 관리하는 방법

IronXL NuGet Install-Package

다음 명령어로 NuGet 패키지 관리자를 통해 IronXL을 설치할 수 있다:

Install-Package IronXl.Excel

위 명령어는 IronXL과 그 모든 종속성을 설치할 것이다.

네임스페이스 추가

Program.cs 클래스의 맨 위 또는 IronXL 메서드를 사용하려는 위치에 다음 네임스페이스를 추가한다.

using IronXL;

using IronXL;

범위에서 데이터 읽기

이제 지정된 셀 범위에서 데이터를 읽어보자.

// Define a range from cell A2 to G10 in the worksheet
var range = sheet["A2:G10"];

// Iterate over each cell in the range and output its value
foreach (var item in range)
{
    Console.WriteLine(item);
}

// Define a range from cell A2 to G10 in the worksheet
var range = sheet["A2:G10"];

// Iterate over each cell in the range and output its value
foreach (var item in range)
{
    Console.WriteLine(item);
}

첫 번째 줄은 워크시트에서 주소 (A2에서 G10까지)의 특정 범위를 선택하여 여러 Excel 셀을 동시에 작업할 수 있게 한다. foreach (var item in range) 루프는 이 셀 범위 내의 각 셀을 반복하여 효율적인 데이터 처리를 가능하게 합니다.

Console.WriteLine(item);을 사용하여 코드가 각 셀의 값을 콘솔에 출력함으로써 범위의 내용을 쉽게 검토할 수 있게 합니다. 이 접근 방식은 데이터 처리을 단순화하고 코드 가독성을 향상시킨다.

범위 내에서 Excel 수식 사용하기

특정 범위를 선택하고 Excel 수식을 일부 구현해보자.

// Define a range from cell F2 to F42 for statistical analysis
var range = sheet["F2:F42"];

// Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}");

// Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}");

// Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {(int)range.Avg()}");

// Define a range from cell F2 to F42 for statistical analysis
var range = sheet["F2:F42"];

// Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}");

// Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}");

// Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {(int)range.Avg()}");

코드 var range = sheet["F2:F42"];는 F2에서 F42까지의 셀 범위를 선택하여 연령 데이터의 통계 분석을 용이하게 합니다. range.Min()과 range.Max()을 사용하여, 지정된 범위 내의 최소 및 최대 연령 값을 효율적으로 계산하여 인구 통계적 통찰력을 얻을 수 있도록 합니다.

추가적으로, range.Avg()는 평균 연령을 계산하여 데이터 해석을 위한 유용한 통계 지표를 제공합니다. 이 접근 방식은 데이터 분석 작업을 단순화하여 정보에 입각한 의사 결정을 위한 필수 통계 정보에 빠르게 접근할 수 있도록 한다.

단일 셀에서 데이터 읽기

단일 셀에서 데이터를 읽어보자.

// Retrieve the value from cell B2 in the worksheet
var read_from_single_cell = sheet["B2"];

// Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}");

// Retrieve the value from cell B2 in the worksheet
var read_from_single_cell = sheet["B2"];

// Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}");

코드 var read_from_single_cell = sheet["B2"];는 워크시트에서 셀 B2에 저장된 값을 가져옵니다. 이 접근 방식을 사용하여 Excel 파일 내 특정 셀 값을 쉽게 접근할 수 있다.

Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}");를 사용하여, 코드가 참조 셀의 가져온 값을 콘솔에 출력하여 데이터 확인 및 디버깅을 용이하게 합니다. 이는 Excel 파일에서 개별 셀 값을 검색하고 표시하는 과정을 단순화한다.

전체 열에서 데이터 읽기

인덱스를 사용하여 전체 열에서 데이터를 읽어봅시다.

// Retrieve values from the column at index 2 (C column) 
var columnValues = sheet.GetColumn(2); // 2 is column index

// Iterate over each value in the column and output it
foreach (var columnValue in columnValues)
{
    Console.WriteLine(columnValue);
}

// Retrieve values from the column at index 2 (C column) 
var columnValues = sheet.GetColumn(2); // 2 is column index

// Iterate over each value in the column and output it
foreach (var columnValue in columnValues)
{
    Console.WriteLine(columnValue);
}

코드 var columnValues = sheet.GetColumn(2);는 워크시트에서 인덱스 2(C 열)에 위치한 열의 모든 값을 가져옵니다. 이렇게 하면 Excel 시트의 특정 열 내 모든 값에 효율적으로 액세스할 수 있습니다.

foreach 루프는 columnValues을 반복하여 열의 각 값을 Console.WriteLine(columnValue);을 사용하여 콘솔에 출력합니다. 이 방법은 Excel 파일에서 열 데이터를 처리하고 표시하여 데이터 분석 작업을 간소화합니다.

또한 인덱스 대신 열 이름을 사용하여 열에서 데이터를 읽을 수 있습니다. 다음 예를 생각해 보세요.

// Retrieve values from the column with name "C"
var columnValues = sheet.GetColumn("C");

// Retrieve values from the column with name "C"
var columnValues = sheet.GetColumn("C");

이 방식으로 여러 열을 지정할 수 있습니다.

전체 행에서 데이터 읽기

행 번호를 사용하여 전체 행에서 데이터를 읽어봅시다.

// Retrieve values from the row at index 1 (Row 2)
var rowValues = sheet.GetRow(1); // 1 is row index

// Iterate over each value in the row and output it
foreach (var rowValue in rowValues)
{
    Console.Write(rowValue + "  ");
}

// Retrieve values from the row at index 1 (Row 2)
var rowValues = sheet.GetRow(1); // 1 is row index

// Iterate over each value in the row and output it
foreach (var rowValue in rowValues)
{
    Console.Write(rowValue + "  ");
}

코드 var rowValues = sheet.GetRow(1);는 워크시트에서 인덱스 1(행 2)에 위치한 단일 행의 모든 값을 가져와서 행 특정 데이터의 효율적인 접근을 가능하게 합니다. foreach 루프는 rowValues을 반복하여 행의 각 값을 Console.Write(rowValue + " ");을 사용하여 콘솔에 출력합니다.

이 방법은 Excel 파일에서 행 데이터를 추출하고 표시하는 과정을 단순화하여 데이터 분석 및 보고 작업을 지원합니다. 이런 방식으로 범위 지정 없이 여러 셀에서 값을 읽을 수 있습니다.

셀 또는 범위에 데이터 쓰기

셀과 범위 둘 다에 데이터를 쓸 수 있습니다. 먼저 범위에 데이터를 씁니다.

// Select a range from D2 to D14 for modification
var range = sheet["D2:D14"];

// Set the value for each cell in the range
range.Value = "Prefer Not to Say"; // Change Gender Value

// Save the modified workbook to persist changes
workbook.Save();

// Select a range from D2 to D14 for modification
var range = sheet["D2:D14"];

// Set the value for each cell in the range
range.Value = "Prefer Not to Say"; // Change Gender Value

// Save the modified workbook to persist changes
workbook.Save();

코드 var range = sheet["D2:D14"];는 셀 D2에서 D14까지의 범위를 선택하여 대량 데이터 수정을 가능하게 합니다. range.Value를 '협조하지 않음'으로 설정하여, 지정된 범위 내의 각 셀의 성별 값을 효율적으로 업데이트하여 반복 작업을 최소화합니다.

후속 workbook.Save(); 명령은 이러한 변경 사항의 지속적인 저장을 보장하여 데이터 일관성과 무결성을 유지합니다. 이 방법은 대량 업데이트를 간소화하고 여러 셀 간의 균일성을 보장하여 데이터 관리 효율성을 향상시킵니다.

이제 특정 셀에 데이터를 씁니다.

// Set the value for cell B2
sheet["B2"].Value = "John";

// Save the workbook to persist the changes
workbook.Save();

// Set the value for cell B2
sheet["B2"].Value = "John";

// Save the workbook to persist the changes
workbook.Save();

코드 sheet["B2"].Value = "John";는 Excel 워크시트의 셀 B2에 직접 'John'이라는 값을 할당하여 특정 셀 값을 업데이트하기 위한 간단하고 직관적인 방법을 제공합니다. 이 방법은 개별 셀 내용을 수정하는 과정을 간소화하여 코드 가독성과 효율성을 향상시킵니다.