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

소개

C#에서는 Microsoft.Office.Interop.Excel dll을 사용하여 간편하게 엑셀 파일에 접근하고, 데이터 읽고 쓰기가 편리합니다. 하지만 C++이나 MFC는 제공되는 라이브러리가 없다 보니 너무나도 불편합니다. 구글에 검색해보면 대부분 Automation class(CXLEzAutomation)를 사용한 방법들이 나오는데요. Github 주소나 개발자 링크가 없어 업데이트는 되는 건지, 버그는 없는지 알 수가 없습니다. 또는 직접 파일에 접근하여 커스터마이즈 된 클래스를 제공하는 게시물도 보았는데요. 이것 역시 잠재적인 버그라든가, 더 이상 업데이트가 없어 범용성이 부족한 경우도 있습니다.

저 역시 이것 저것 시도해보다가 XLNT 라이브러리를 알게되었고, 간편하게 엑셀 파일 읽고 쓰기 작업이 가능했습니다. 이 XLNT는 오픈소스 기반의 C++ 라이브러리로, 크로스 플랫폼 개발이 가능합니다. 라이브러리의 자세한 내용은 아래 Github에 접속하여 확인하세요.

XLNT:  https://github.com/tfussell/xlnt

tfussell/xlnt

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

준비 단계

본문의 프로젝트는 Visual Studio 2017 x64 환경의 MFC Dialog 프로젝트로 진행됩니다. Visual Studio 2015에서도 동작하는 것은 확인했습니다.

그리고 XLNT를 사용하기 위해서는 CMake 프로그램이 필요합니다. 일반적인 상용 라이브러리들은 .Net 또는 C++용 라이브러리(dll, h, lib)를 제공하는데요. 이러한 오픈 소스 기반의 라이브러리들은 CMake를 이용하여 개발자의 환경에 맞게 라이브러리를 빌드해야 합니다.

CMake는 아래 링크에서 다운로드 가능합니다.
링크: https://cmake.org/download/

만약, CMake가 무엇인지 모르겠고 Visual Studio 2017 x64 라이브러리만 필요하다면, 제가 미리 빌드해 놓은 파일을 다운로드하여 사용하세요.

Visual Studio 2017 x64 XLNT Library.zip

2.40MB

CMake로 XLNT 라이브러리 생성하기

주의

 

 

따라 하기 전에, 하나 주의사항이 있습니다. XLNT를 빌드하는 과정 중 Compile Error가 발생하는데요. 추측하기로는 소스 파일 일부가 UTF-8과 관련된 것으로 보입니다. 해당 소스 파일을 강제로 UTF-8로 저장하면 문제없이 빌드되고, 생성된 라이브러리를 사용하는데 문제는 없습니다만, 조금 찝찝한 부분이긴 합니다.

그럼, 시작하겠습니다. XLNT Github에 접속하여 Source code (zip) 파일을 다운로드한 후 압축을 해제합니다. (저는 XLNT 1.5를 다운로드하였습니다.) 

CMake 프로그램을 실행하고 아래의 설명처럼 경로를 지정합니다. 

CMake 실행 후 경로가 지정된 화면

항목	설명
Where is the source code	Library의 Source code 경로를 입력합니다.
Where to build the binaries	Build된 파일이 생성되는 경로를 입력합니다.

Configure 버튼을 클릭하면 개발 환경을 입력하는 창이 표시됩니다. 자신의 개발 환경에 맞춰 입력한 후 Finish 버튼을 클릭합니다.

개발 환경 입력 화면

개발 환경을 입력하면 다음과 같이 빌드 속성을 변경하는 화면이 보입니다. 아래의 설명처럼 경로를 수정합니다.

빌드 속성 변경 화면

항목	설명
CMAKE_INSTALL_PREFIX	기본 경로에 ${BUILD_TYPE}을 붙이면 Debug, Release 모드 폴더 별로 라이브러리가 생성.

입력을 마쳤으면 Generate 버튼을 클릭합니다. 그리고 Where to build the binaries에 입력한 경로에 들어가 보면 프로젝트가 생성되어 있습니다. xlnt_all.sln을 실행합니다.

라이브러리 생성을 위한 프로젝트

ALL_BUILD 프로젝트를 선택한 후 빌드합니다.

xlnt_all 솔루션 화면

앞서 얘기한 바와 같이 빌드 실패가 메시지가 보입니다.

빌드 실패

아래의 위치에서 에러가 발생했는데요.

에러 발생 위치

에러가 발생한 소스 파일을 메모장으로 열은 후 다시 덮어쓰기로 저장합니다.

에러가 발생한 파일

아래처럼 메모장으로 열고 '다른 이름으로 저장'을 클릭한 후 덮어쓰기로 저장합니다.

메모장으로 열은 모습

다시 Visual Studio로 돌아오면 아래의 경고 메시지가 표시됩니다. '모두 예' 버튼을 클릭합니다.

경고 메시지

그리고 다시 빌드를 하면 성공합니다.

빌드 성공 메시지

다음으로 INSTALL 프로젝트를 선택하고 빌드합니다. INSTALL 프로젝트는 별문제 없이 빌드에 성공합니다.

빌드 성공 메시지

프로젝트 빌드 완료 후 binaries 경로에 installed 폴더가 생성되어 있습니다.

라이브러리 생성

여기까지, 라이브러리 생성 과정이었습니다.

MFC에서 XLNT 라이브러리 사용하기

MFC Dialog 프로젝트 생성 후, 이전에 생성한 라이브러리 파일을 복사하여 붙여 넣습니다.

프로젝트에 라이브러리 파일 포함

그리고 프로젝트의 속성을 변경합니다. 먼저, dll 위치를 설정합니다.

DLL 경로 설정

항목	값
구성 속성 > 디버깅 > 환경	PATH=$(ProjectDir)\bin;%PATH%

헤더 파일 경로를 설정합니다.

헤더 파일 경로 설정

항목	값
구성 속성 > C/C++ > 일반 > 추가 포함 디렉터리	$(ProjectDir)include;

마찬가지로 라이브러리 경로도 설정합니다.

라이브러리 경로 설정

항목	값
구성 속성 > 링커 > 일반 > 추가 라이브러리 디렉터리	$(ProjectDir)lib

마지막으로 불러올 라이브러리 파일을 입력합니다.

라이브러리 파일 설정

항목	값
구성 속성 > 링커 > 입력 > 추가 종속성	xlntd.lib

여기까지 프로젝트의 속성 설정이었고, 이제 헤더 파일에서 다음과 같이 파일을 include 합니다.

#include <xlnt/xlnt.hpp>

잘 따라오셨나요? 프로젝트 설정 단계가 많아 보이지만, 기본적으로 외부 라이브러리를 사용하면 거치는 단계이므로 꼭 숙지하시길 바랍니다.

자, 이제 프로젝트에 버튼 두 개를 추가하고, 각 버튼 이벤트에 엑셀 데이터를 생성하는 코드와 읽어오는 코드를 작성해 보겠습니다.

// 엑셀 파일 생성 예제
void CExamXLNTDlg::OnBnClickedBtnCreate()
{
	xlnt::workbook wb;
	xlnt::worksheet ws = wb.active_sheet();
	ws.cell("A1").value(5);
	ws.cell("B2").value("string data");
	ws.cell("C3").formula("=RAND()");
	ws.merge_cells("C3:C4");
	ws.freeze_panes("B2");
	wb.save("example.xlsx");
}

// 엑셀 파일 읽어오는 예제
void CExamXLNTDlg::OnBnClickedBtnRead()
{
	xlnt::workbook wb;
	wb.load("example.xlsx");

	xlnt::worksheet ws = wb.active_sheet();
	int val = ws.cell("A1").value<int>();
}

엑셀 데이터 생성 버튼을 클릭하면 example.xlsx 파일이 생성되고, 파일을 열면 아래와 같은 데이터가 입력되어 있습니다.

실행 결과

엑셀 데이터 불러오기 버튼을 클릭하면 A1 셀의 값인 5가 반환될 것입니다.

주의

 

 

만약, 프로그램 종료 후 출력 창에 메모리 누수 메시지가 보인다면 아래 그림과 같이 MFC 사용을 정적 라이브러리에서 MFC 사용으로 변경해 보세요. C++에서는 발생하지 않고, MFC에서만 발생하는 것으로 보아 False Memory로 추측됩니다.

MFC 사용 옵션 변경 화면

본문의 샘플 코드는 아래 첨부 파일을 참고하세요.

Exam_XLNT.zip

1.66MB