HOWTO · Csharp
C#으로 Excel 파일에 데이터 내보내기
C# 객체 컬렉션, 배열, DataTable, JSON 레코드를 Excel 통합 문서로 내보내는 방법을 비교합니다.
이 페이지의 내용
입력 데이터에 맞는 내보내기 방법을 선택하세요. 객체 컬렉션은 워크시트에 매핑하고, 2차원 배열은 셀에 배치하며, DataTable은 열 이름과 함께 기록할 수 있습니다. JSON 레코드는 먼저 역직렬화한 뒤 각 필드를 워크시트에 매핑합니다. 아래에서는 각 방식으로 만들려는 통합 문서의 구성을 설명합니다. 라이브러리 관련 내용은 검증되지 않은 예시입니다. 대상 프레임워크, 패키지 버전, 실행 증거가 제공되지 않았으므로 적용하기 전에 호환되는 패키지, API 서명, 라이선스 조건을 각 공급업체의 최신 문서에서 확인하세요.
C#을 사용하여 Excel로 데이터 내보내기
학생과 같은 레코드를 내보내려면 원하는 값을 속성으로 제공하는 객체 컬렉션을 준비합니다. 예를 들어 각 Student 객체에 name 속성과 숫자형 marks 속성이 있을 수 있습니다. 워크시트에서는 학생 한 명을 한 행으로 표시하고, 두 필드의 이름을 머리글에 둡니다. 애플리케이션이 이미 형식이 지정된 레코드를 다루고 있고 그 속성을 워크시트에 반영하려는 경우에 적합한 데이터 형태입니다.
원래 예시는 ExcelMapper와 ExcelMapper NuGet 패키지를 언급합니다. 이를 검증된 설치 안내로 간주하지 말고, 조사할 라이브러리 후보로만 보세요. 컬렉션을 매핑하고 ShaniData 같은 워크시트를 선택해 .xlsx 파일로 저장하는 현재 방법은 해당 패키지 공급업체의 문서에서 확인해야 합니다. 통합 문서를 저장할 수 있는 경로도 지정해야 합니다. 의도된 결과는 학생 이름과 점수를 담은 워크시트이지만, 여기서는 출력 파일이나 스크린샷을 검증하지 않았습니다.
C#을 사용하여 배열에서 Excel로 데이터 내보내기
값이 이미 직사각형 표 형태라면 2차원 배열을 사용할 수 있습니다. 첫 번째 행에는 Name, City, Gpa, Language와 같은 필드 이름을 두고, 그다음 행부터 레코드를 하나씩 배치합니다. 각 행의 값 개수를 동일하게 맞춰야 각 값이 의도한 열 머리글 아래에 놓입니다.
제공된 예시는 Spire.Xls를 사용하고 ShaniArray라는 워크시트를 만든 뒤, 행과 열 인수로 2, 1을 전달해 InsertArray를 호출합니다. 이는 워크시트의 두 번째 행과 첫 번째 열에서 시작하려는 구성을 나타냅니다. 다만 이 API의 인덱스 기준은 현재 문서에서 확인한 뒤 사용하세요. 배열에 머리글 행이 포함되어 있으므로 두 번째 행부터 삽입하면 워크시트의 첫 행을 별도 제목이나 빈 공간으로 남길 수 있습니다. 원래 패키지 제목에는 ExcelMapper가 적혀 있었지만 예시의 참조는 Spire.Xls였습니다. 실제로 선택한 패키지의 문서를 기준으로 확인하세요. 의도된 결과는 머리글과 레코드가 있는 표를 Excel 통합 문서로 저장하는 것입니다.
C#을 사용하여 DataTable에서 Excel로 데이터 내보내기
열 이름과 행이 .NET의 표 형식 데이터 모델에 이미 들어 있다면 DataTable을 사용하세요. Roll Number, Student Name, Section과 같은 열을 정의하고 학생마다 DataRow를 추가합니다. 워크시트 첫 행에는 열 이름을 표시하고 그 아래에 테이블 값을 배치하는 것이 의도된 구성입니다. 각 행에 선언한 모든 열의 값이 있는지 확인하세요.
이 문서의 예시는 Spire.Xls를 참조하며 열 이름을 포함해 테이블을 삽입하려는 구성입니다. 하지만 패키지 안내에는 잘못해서 ExcelMapper라고 적혀 있었습니다. 선택한 라이브러리에 맞는 패키지와 현재 테이블 삽입 API는 해당 라이브러리 문서에서 확인하세요. 삽입 인수와 저장 호출은 여기서 검증하지 않았으므로, 설치한 버전에 맞춰 인수의 의미와 워크시트 좌표, 출력 경로를 확인해야 합니다. 기존 쿼리나 애플리케이션 로직이 이미 DataTable을 반환하고 열 이름을 통합 문서에도 유지하고 싶을 때 유용한 방식입니다.
C#을 사용하여 JSON에서 Excel로 데이터 내보내기
예시 데이터는 JSON 파일이 아니라 코드 안에 직접 작성한 JSON 문자열입니다. Name, Roll, GPA, Fyp 필드가 있는 번호별 학생 레코드를 담고 있습니다. 이 문자열을 학생 객체 컬렉션이나 사전으로 역직렬화한 다음, 각 필드를 Student Name, Roll No, GPA, FYP와 같은 워크시트 열에 매핑할 수 있습니다. JSON 파일을 처리하려면 역직렬화 전에 파일을 읽는 단계가 별도로 필요하며, 그 단계는 이 예시에 포함되어 있지 않습니다.
원문은 역직렬화에 Newtonsoft.Json, 통합 문서 생성에 GemBox.Spreadsheet를 사용한다고 설명합니다. 각 라이브러리의 역할을 구분하세요. 선택한 스프레드시트 라이브러리로 통합 문서를 초기화하고 ShaniJSON 워크시트를 만든 뒤, 머리글을 쓰고 각 레코드를 그 아래에 추가하여 파일을 저장하는 것이 의도된 흐름입니다. 원래 매핑에서는 JSON 키 Name을 C# 속성 Fname에 연결하므로, 실제 속성 이름에 맞는 직렬 변환기 설정이 필요합니다. 원문은 Workbook과 ExcelFile을 혼용했으므로, 서로 호환되지 않는 조각을 합치지 말고 현재 GemBox 문서에서 워크북 형식과 저장 메서드를 확인하세요. 프로젝트에 맞는 JSON 패키지 호환성과 라이선스 조건도 확인해야 합니다. 컴파일, 실행 결과 또는 생성된 통합 문서를 검증했다고 주장하지 않습니다.