C#에서 GroupDocs.Conversion for .NET을 사용하여 DGN을 Excel (XLSX)로 변환하기
소개
DGN을 Excel로 변환해야 한다면, .NET용 GroupDocs.Conversion은 모든 .NET 플랫폼에서 작동하는 빠르고 신뢰할 수 있는 솔루션을 제공합니다. 이 튜토리얼에서는 라이브러리 설치, 변환 구성, AutoCAD 디자인(DGN) 파일을 깔끔한 XLSX 스프레드시트로 변환하는 코드를 실행하는 과정을 단계별로 안내합니다. 끝까지 읽으면 이 접근 방식이 기업 파이프라인에서 선호되는 이유와 이를 자체 프로젝트에 통합하는 방법을 이해하게 됩니다.
빠른 답변
- DGN을 Excel로 변환하는 라이브러리는 무엇인가요? GroupDocs.Conversion for .NET.
- 기본 구현에 얼마나 걸리나요? 작성 및 실행에 약 10‑15 분 정도 소요됩니다.
- 지원되는 .NET 버전은 무엇인가요? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6+.
- 프로덕션에 라이선스가 필요합니까? 예 – 유료 라이선스를 사용하면 체험 제한이 해제됩니다.
- NuGet을 통해 설치할 수 있나요? 물론입니다 –
GroupDocs.Conversion패키지를 사용하세요.
DGN을 Excel로 변환이란?
DGN을 Excel로 변환은 DGN(MicroStation) 도면에서 표 형식 및 속성 데이터를 추출하여 Excel 워크북(XLSX)으로 저장하는 과정입니다. 이를 통해 수동 데이터 입력 없이 하위 분석, 보고 및 비즈니스 시스템과의 통합이 가능해집니다.
왜 .NET용 GroupDocs.Conversion을 사용하여 DGN을 Excel로 변환할까요?
.NET용 GroupDocs.Conversion은 50개 이상의 입력 및 출력 형식을 지원하며 전체 문서를 메모리에 로드하지 않고 수백 페이지에 달하는 DGN 파일을 처리할 수 있어 RAM 사용량을 최대 70 %까지 줄입니다. 또한 라이브러리는 테이블, 레이어 및 속성 데이터를 보존하며 벤치마크 테스트에서 변환 정확도 > 98 %를 달성합니다.
전제 조건
- GroupDocs.Conversion for .NET 버전 25.3.0 (또는 이후 버전).
- .NET Core 3.1, .NET 5/6, 또는 .NET Framework 4.6+가 설치된 개발 환경.
- 기본 C# 지식 및 NuGet Package Manager 접근 권한.
필요한 라이브러리 및 버전
- GroupDocs.Conversion for .NET 버전 25.3.0.
환경 설정 요구 사항
- .NET (가능하면 .NET Core 또는 .NET Framework) 개발 환경.
지식 전제 조건
- C# 프로그래밍에 대한 기본 이해.
- NuGet Package Manager 사용에 익숙함.
전제 조건이 준비되었으니, 이제 GroupDocs.Conversion for .NET을 설치해 보겠습니다.
NuGet을 통해 GroupDocs Conversion을 설치하는 방법?
설치는 간단합니다: Visual Studio를 열고, 패키지 관리자 콘솔을 실행한 뒤 Install‑Package 명령을 실행합니다. NuGet 시스템이 모든 종속성을 해결하고 GroupDocs.Conversion 어셈블리를 프로젝트에 추가하며 프로젝트 파일을 업데이트하여 즉시 코딩을 시작할 수 있게 합니다.
Install-Package GroupDocs.Conversion
또는 .NET CLI를 사용하여 실행합니다:
dotnet add package GroupDocs.Conversion
두 명령 모두 NuGet 저장소에서 최신 안정 버전을 가져와 필요한 모든 종속성을 확보합니다.
설치
Install-Package GroupDocs.Conversion -Version 25.3.0
.NET CLI
dotnet add package GroupDocs.Conversion --version 25.3.0
라이선스 획득 단계
GroupDocs는 다양한 라이선스 옵션을 제공합니다:
- 무료 체험 – 기본 기능을 테스트합니다.
- 임시 라이선스 – 대규모 프로젝트를 위한 평가 기간을 연장합니다.
- 구매 – 전체 프로덕션 사용. 공식 스토어는 GroupDocs에서 확인하세요.
기본 초기화 및 설정
GroupDocs.Conversion은 파일 변환을 조정하는 핵심 클래스입니다. 패키지를 추가한 후, 소스 파일 경로와 선택적 구성을 사용하여 Converter 객체를 인스턴스화합니다.
Initialize the converter
Converter는 문서를 로드하고 변환을 수행하는 기본 클래스입니다.
using System;
using GroupDocs.Conversion;
// Initialize the converter with the source DGN file path
var documentPath = "YOUR_DOCUMENT_DIRECTORY\sample.dgn";
using (var converter = new Converter(documentPath))
{
// Conversion logic will go here
}
설정이 완료되었으니, 변환 프로세스를 구현해 보겠습니다.
C#에서 DGN을 Excel로 변환하는 방법?
변환 워크플로는 DGN 파일을 로드하고, 스프레드시트 옵션을 구성한 뒤 Convert 메서드를 호출하는 단계로 이루어집니다. Converter 클래스와 SpreadsheetConvertOptions를 함께 사용하면 시트 이름, 메타데이터 포함 여부, 페이지 제한 등을 제어하여 어떤 규모의 도면이든 효율적이고 정확한 Excel 출력물을 만들 수 있습니다.
소스 DGN 파일 로드
먼저 입력 DGN과 출력 XLSX에 대한 절대 경로나 상대 경로를 정의합니다.
단계 1: 파일 경로 정의
string documentPath = System.IO.Path.Combine("YOUR_DOCUMENT_DIRECTORY", "sample.dgn");
string outputFolder = System.IO.Path.Combine("YOUR_OUTPUT_DIRECTORY", "output");
string outputFile = System.IO.Path.Combine(outputFolder, "dgn-converted-to.xlsx");
// Ensure the output directory exists
if (!System.IO.Directory.Exists(outputFolder))
{
System.IO.Directory.CreateDirectory(outputFolder);
}
단계 2: DGN 파일 로드
using (var converter = new Converter(documentPath))
{
// Conversion process will be defined here
}
변환 옵션 설정
ConversionException은 변환 과정에서 오류가 발생했을 때 발생합니다.SpreadsheetConvertOptions는 시트 명명, 메타데이터 포함, 페이지 범위 등 Excel 출력 설정을 정의합니다.
// Specify that we're converting to an Excel spreadsheet format
var options = new SpreadsheetConvertOptions();
변환 수행
마지막으로 변환을 실행하고 결과를 디스크에 저장합니다.
단계 4: 변환 실행 및 저장
converter.Convert(outputFile, options);
문제 해결 팁
- 권한 – 프로세스가 폴더에 대한 읽기/쓰기 권한을 가지고 있는지 확인하세요.
- 오류 처리 – 변환 호출을
try‑catch블록으로 감싸ConversionException을 포착하고 상세 정보를 로그에 기록하세요.
일반적인 문제 및 해결책
| 문제 | 해결책 |
|---|---|
| “파일을 찾을 수 없습니다” 오류 | 상대 경로를 해결하고 파일이 존재하는지 확인하기 위해 Path.GetFullPath를 사용합니다. |
| 대용량 DGN에서 메모리 급증 | ConverterOptions.PageRange를 설정하여 변환당 페이지 수를 제한함으로써 파일을 청크로 처리합니다. |
| Excel에서 데이터 누락 | 속성 테이블을 유지하려면 SpreadsheetConvertOptions.IncludeMetadata = true를 활성화합니다. |
실용적인 적용 사례
- 프로젝트 관리 – 자재 명세서와 일정 데이터를 스프레드시트로 내보내 추적합니다.
- 데이터 분석 – CAD에서 추출한 데이터를 Excel 피벗 테이블 및 차트로 활용합니다.
- ERP 통합 – 설계 사양을 ERP 시스템으로 자동 전송합니다.
성능 고려 사항
- 배치 실행 중 사용하지 않는 애플리케이션을 닫습니다.
using문을 사용하여 객체를 즉시 해제합니다.- 가능하면 단일
Converter인스턴스를 재사용하여 여러 파일을 처리합니다.
결론
이제 .NET용 GroupDocs.Conversion을 사용하여 DGN을 Excel (XLSX)로 변환하는 완전한 프로덕션 준비 패턴을 보유하게 되었습니다. 이 접근 방식은 수동 데이터 입력을 줄이고 보고 속도를 높이며 .NET 기반 백엔드 서비스와 원활하게 통합됩니다. 추가 형식(PDF, DOCX, PPTX)도 탐색하여 자동화 파이프라인을 확장해 보세요.
자주 묻는 질문
Q: 다른 CAD 형식도 DGN 외에 변환할 수 있나요?
A: 예, GroupDocs.Conversion은 DWG, DXF, DWF 파일도 지원하므로 동일한 XLSX 출력으로 변환할 수 있습니다.
Q: 체험 버전의 파일 크기 제한이 있나요?
A: 무료 체험은 5 MB 미만 파일만 변환하도록 제한되며, 임시 또는 유료 라이선스를 사용하면 이 제한이 해제됩니다.
Q: 비밀번호가 설정된 DGN 파일은 어떻게 처리하나요?
A: ConverterSettings.Password를 통해 비밀번호를 Converter 생성자에 전달합니다.
Q: 라이브러리가 Linux 컨테이너에서 작동하나요?
A: 물론입니다 – GroupDocs.Conversion은 크로스 플랫폼이며 .NET Core 기반 Docker 이미지에서 실행됩니다.
Q: 자세한 API 문서는 어디서 찾을 수 있나요?
A: 공식 문서는 문서에서 확인하세요.
마지막 업데이트: 2026-06-30
테스트 환경: GroupDocs.Conversion 25.3.0 for .NET
작성자: GroupDocs
리소스
행복한 코딩 되시고, GroupDocs.Conversion for .NET의 전체 잠재력을 탐색해 보세요!