[.Net] C#에서 엑셀(Excel) 파일 다루는 방법 (예제 포함)

C#에서 쉽게 엑셀(Excel) 사용하기

이전에 MFC에서 XLNT 라이브러리를 사용한 엑셀 파일 다루는 방법을 소개한 적이 있습니다.

[MFC] MFC에서 XLNT를 이용한 엑셀(Excel)파일 읽고 쓰기 (예제 포함)

[MFC] MFC에서 XLNT를 이용한 엑셀(Excel)파일 읽고 쓰기 (예제 포함)

MFC에서는 XLNT 라이브러리를 CMake로 빌드하고, 프로젝트에 설정하는 등의 과정이 귀찮았습니다. 하지만 C#은 다릅니다. 누겟(NuGet)에서 Excel dll만 설치하면 바로 사용할 수 있습니다.

그럼, 본문에서 본격적으로 C#에서 엑셀 파일을 다루기 위한 방법을 설명하겠습니다.

본문의 샘플 코드는 하단에 첨부되어 있습니다.

준비 단계

ExamWinformExcel이라는 이름의 WinForm 프로젝트를 생성하고, NuGet 패키지 관리 메뉴를 클릭합니다.

프로젝트 생성 후 NuGet 패키지 관리 메뉴 클릭

찾아보기 탭에서 Excel을 검색하고, Microsoft.Office.Interop.Excel 항목을 선택한 후 설치 버튼을 클릭합니다.

Microsoft.Office.Interop.Excel 설치

설치가 완료되면 아래의 네임 스페이스를 정의합니다.

using Microsoft.Office.Interop.Excel;

Excel 파일 불러오기

컴퓨터에 존재하는 엑셀 파일을 불러오도록 하겠습니다.

using Microsoft.Office.Interop.Excel;
using System.Runtime.InteropServices;

private void buttonOpen_Click(object sender, EventArgs e)
{
	Microsoft.Office.Interop.Excel.Application application = null;
	Workbook workBook = null;

	try
	{
		OpenFileDialog dlg = new OpenFileDialog();
		if (dlg.ShowDialog() != DialogResult.OK)
			return;

		//Excel 프로그램 실행
		application = new Microsoft.Office.Interop.Excel.Application();
		//Excel 화면 띄우기 옵션
		application.Visible = true;
		//파일로부터 불러오기
		workBook = application.Workbooks.Open(dlg.FileName);
	}
	catch(Exception exc)
	{
		MessageBox.Show(exc.Message);
	}
	finally
	{
		//변경점 저장하면서 닫기
		workBook.Close(true);
		//Excel 프로그램 종료
		application.Quit();
		//오브젝트 해제
		ReleaseExcelObject(workBook);
		ReleaseExcelObject(application);
	}
}

private void ReleaseExcelObject(object obj)
{
	try
	{
		if (obj != null)
		{
			Marshal.ReleaseComObject(obj);
			obj = null;
		}
	}
	catch (Exception ex)
	{
		obj = null;
		throw ex;
	}
	finally
	{
		GC.Collect();
	}
}

위 코드를 보면, Application 객체를 생성하고 Workbook 객체를 생성하는 순서입니다. 해제할 때는 반대로 Workbook 객체를 닫고 Application 객체를 종료하죠. 메모리 해제 순서도 동일합니다. 이 순서를 꼭 지켜야 예외 메시지가 발생하지 않습니다.

코드에서 10번째 코드는 Excel 화면을 띄울지에 대한 옵션입니다. 이 코드 한 줄이 실행되면 아래와 같이 비어있는 엑셀 프로그램이 실행됩니다. 만약, 업무 자동화 프로그램이라면 굳이 띄울 필요가 없겠죠? 그럴 경우에는 false로 설정하면 됩니다.

Excel Application이 실행된 모습

그리고 12번째 코드가 실행되면 특정 경로의 파일을 정상적으로 불러옵니다.

Excel 파일이 불러와진 모습

Excel 파일 저장하기

저장하는 과정은 불러오는 과정과 유사합니다.

private void buttonSave_Click(object sender, EventArgs e)
{
	Microsoft.Office.Interop.Excel.Application application = null;
	Workbook workBook = null;

	try
	{
		SaveFileDialog dlg = new SaveFileDialog();
		dlg.Filter = "xlsx files|*.xlsx";
		if (dlg.ShowDialog() != DialogResult.OK)
			return;

		application = new Microsoft.Office.Interop.Excel.Application();
		application.Visible = true;

		//Workbook 생성
		workBook = application.Workbooks.Add();
		//특정 경로에 엑셀 파일로 저장
		workBook.SaveAs(dlg.FileName, XlFileFormat.xlWorkbookDefault);
	}
	catch (Exception exc)
	{
		MessageBox.Show(exc.Message);
	}
	finally
	{
		workBook.Close(true);
		application.Quit();

		ReleaseExcelObject(workBook);
		ReleaseExcelObject(application);
	}
}

불러오기와 다른 부분은 13번째, 15번째 코드입니다. 13번째 코드는 비어있는 Application에 새로운 Workbook을 추가하는 것이고, 15번째 코드는 특정 경로에 엑셀 파일로 저장하는 것입니다. 저장하는 과정도 아주 간단합니다.

시트(Sheet) 추가 및 이름 변경하기

이번에는 새로 만든 엑셀 파일에 Sheet를 추가하고 이름을 변경해 보겠습니다. 그리고 특정 셀에 데이터도 입력해 보겠습니다.

private void buttonEditSave_Click(object sender, EventArgs e)
{
	Microsoft.Office.Interop.Excel.Application application = null;
	Workbook workBook = null;
	Worksheet workSheet = null;

	try
	{
		SaveFileDialog dlg = new SaveFileDialog();
		dlg.Filter = "xlsx files|*.xlsx";
		if (dlg.ShowDialog() != DialogResult.OK)
			return;

		application = new Microsoft.Office.Interop.Excel.Application();
		application.Visible = true;

		workBook = application.Workbooks.Add();
		
		//마지막 시트 뒤에 새로운 시트 추가
		workSheet = workBook.Worksheets.Add(After: workBook.Worksheets.Item[workBook.Worksheets.Count]);
		//시트 이름 변경
		workSheet.Name = "테스트 시트";
		//1행 1열에 문자열 "테스트" 입력
		Range cell1 = workSheet.Cells[1, 1];
		cell1.Value = "테스트";
		//2행 1열에 숫자 "1234" 입력
		Range cell2 = workSheet.Cells[2, 1];
		cell2.Value = "1234";
		//2행 2열에 문자열 "ABCD※" 입력
		Range cell3 = workSheet.Cells[2, 2];
		cell3.Value = "ABCD※";

		workBook.SaveAs(dlg.FileName, XlFileFormat.xlWorkbookDefault);
	}
	catch (Exception exc)
	{
		MessageBox.Show(exc.Message);
	}
	finally
	{
		workBook.Close(true);
		application.Quit();

		ReleaseExcelObject(workBook);
		ReleaseExcelObject(application);
	}
}

시트를 그냥 추가해서는 안되고, 20번째 코드처럼 어느 위치 이후(After) 또는 이전(Before)으로 추가해야 시트가 삽입됩니다. 그리고 이름 변경은 22번째 코드처럼 간단합니다. 마지막으로 셀에 데이터를 추가하는 방법도 아주 간단합니다.

위 코드를 실행한 결과는 아래 그림과 같습니다.

셀 입력 및 시트 추가, 이름 변경한 결과

자세한 내용은 아래 첨부된 예제 코드를 참고하세요.

ExamWinformExcel.zip

0.01MB