GroupDocs.Conversion .NET을 사용하여 DGN 파일을 TXT로 변환하는 방법
소개
복잡한 DGN 파일을 보다 관리하기 쉬운 TXT 형식으로 변환하고 **create output folder C#**를 효율적으로 만들 방법을 찾고 계신가요? 많은 건축가, 엔지니어 및 건설 전문가들은 보고서, 데이터 분석 파이프라인 또는 레거시 시스템과의 통합을 위해 CAD 도면에서 순수 텍스트 데이터를 추출해야 합니다. 이 튜토리얼에서는 GroupDocs.Conversion .NET을 사용하여 DGN 파일을 로드하고, 적절한 출력 디렉터리를 설정하며, 깔끔한 TXT 파일을 생성하는 방법을 단계별로 안내합니다—모두 명확하고 프로덕션 준비된 코드와 함께 제공합니다.
배울 내용
- GroupDocs.Conversion for .NET 설정 방법
- **create output folder C#**를 만들고 변환된 파일의 대상 경로를 지정하는 방법
- DGN 파일을 로드하고 TXT로 변환하는 방법
- 변환 프로세스를 세밀하게 조정할 수 있는 주요 구성 옵션
빠른 답변
- DGN‑to‑TXT 변환을 처리하는 라이브러리는 무엇인가요? GroupDocs.Conversion .NET
- 프로덕션 사용을 위해 라이선스가 필요합니까? 예, 전체 라이선스 또는 임시 라이선스가 필요합니다.
- 이 코드를 .NET 6에서 실행할 수 있나요? 물론입니다 – 라이브러리는 .NET 5/6, .NET Core 3.1 및 .NET Framework 4.5+를 지원합니다.
- C#에서 출력 폴더를 어떻게 만들나요? 변환 전에
Directory.CreateDirectory(path)를 사용합니다. - 일반적인 변환 속도는 어떻게 되나요? 200페이지 DGN을 TXT로 변환하는 데 일반 서버에서는 보통 2초 미만이 소요됩니다.
“create output folder C#”란 무엇인가요?
**Create output folder C#**는 파일을 쓰기 전에 파일 시스템에 디렉터리가 존재하도록 프로그래밍 방식으로 보장하는 것을 의미하며, 일반적으로 System.IO.Directory.CreateDirectory를 사용합니다. 이는 파일 쓰기 작업 중 “경로를 찾을 수 없음” 오류를 방지합니다.
CAD to TXT 변환에 GroupDocs.Conversion을 사용하는 이유는?
GroupDocs.Conversion은 DGN, DWG, DXF 등을 포함한 50+ input and output formats를 지원하며, 전체 문서를 메모리에 로드하지 않고도 2 GB까지의 파일을 처리할 수 있습니다. 고유 텍스트 추출 엔진은 레이어 이름, 주석 및 속성 데이터를 보존하여 원본 도면의 텍스트 내용을 99 % fidelity로 반영한 TXT 파일을 제공합니다.
필수 조건
- GroupDocs.Conversion .NET 라이브러리 (버전 25.3.0 이상)
- Visual Studio 2022 (또는 C# 8.0+를 지원하는 IDE)
- .NET 6 SDK (또는 .NET Core 3.1 / .NET Framework 4.5+)
- 유효한 GroupDocs 라이선스 (무료 체험 또는 임시 라이선스는 테스트에 사용 가능)
.NET용 GroupDocs.Conversion 설정
선택한 패키지 관리자를 사용하여 GroupDocs.Conversion 라이브러리를 설치합니다.
NuGet 패키지 관리자 콘솔:
Install-Package GroupDocs.Conversion -Version 25.3.0
.NET CLI:
dotnet add package GroupDocs.Conversion --version 25.3.0
Pro tip: 설치 후 라이선스 파일을 프로젝트에 추가하고 애플리케이션 시작 시 로드하여 런타임 라이선스 오류를 방지하세요.
기본 초기화
Converter 클래스는 소스 파일을 로드하고 형식 변환을 수행하는 GroupDocs.Conversion의 핵심 구성 요소입니다.
using System;
using GroupDocs.Conversion;
// Initialize the conversion handler
class Program
{
static void Main()
{
var converter = new Converter("path/to/your/file.dgn");
Console.WriteLine("Setup complete. Ready to convert!");
}
}
구현 가이드
C#에서 출력 폴더를 어떻게 만들나요?
Directory.CreateDirectory는 지정된 경로에 디렉터리와 하위 디렉터리가 존재하지 않을 경우 모두 생성합니다.
Directory.CreateDirectory를 사용하여 변환 API를 호출하기 전에 대상 경로가 존재하는지 확인하세요. 이 한 줄 코드는 폴더가 없으면 생성하고, 이미 존재하면 조용히 성공하여 파일 쓰기 중 “디렉터리를 찾을 수 없음” 예외를 방지합니다. 또한 전체 경로를 반환하므로 로그 기록이나 추가 처리에 재사용할 수 있습니다.
string outputFolder = Path.Combine(Environment.CurrentDirectory, "ConvertedFiles");
Directory.CreateDirectory(outputFolder);
DGN 파일을 로드하고 TXT로 변환
개요
이 기능을 사용하면 DGN 파일을 로드하고 순수 텍스트(TXT) 형태로 변환할 수 있으며, 이는 건축 도면에서 설계 노트, 메타데이터 또는 삽입된 주석을 추출하는 데 유용합니다.
1단계: 출력 디렉터리 경로 정의
변환된 파일을 저장할 위치를 지정합니다. 아래 예제는 애플리케이션 루트 디렉터리에 ConvertedFiles라는 폴더를 생성합니다.
string outputFolder = Path.Combine("YOUR_OUTPUT_DIRECTORY", "ConvertedFiles");
Directory.CreateDirectory(outputFolder); // Ensure directory exists
Why: 전용 출력 경로를 정의하면 프로젝트가 정리되고, 후속 처리에 필요한 생성된 TXT 파일을 쉽게 찾을 수 있습니다.
2단계: 변환 옵션 설정
TxtConvertOptions 클래스는 변환에 필요한 설정을 보유하며, 줄 바꿈, 인코딩 및 숨겨진 레이어 포함 여부를 사용자 정의할 수 있습니다.
var txtOptions = new TxtConvertOptions
{
Encoding = Encoding.UTF8,
IncludeHiddenLayers = false
};
What It Does: 이 객체는 변환기에 텍스트 표현을 어떻게 렌더링할지 정확히 알려주어, 다양한 DGN 소스 간에 일관된 결과를 보장합니다.
3단계: 변환 수행
이전에 정의한 옵션으로 변환을 실행합니다. 람다 식은 출력 파일을 즉시 생성하여 임시 저장소를 사용하지 않습니다.
var convertOptions = new TextConvertOptions();
Why: Save에 람다를 사용하면 출력 스트림을 완전히 제어할 수 있어, 변환을 웹 서비스나 백그라운드 작업에 통합할 때 특히 유용합니다.
4단계: 변환 실행
마지막으로 Convert 메서드를 호출하여 소스 DGN 경로, 대상 형식 및 옵션 객체를 전달합니다.
converter.Convert(() => File.Create(Path.Combine(outputFolder, "output.txt")), convertOptions);
Why: 이 메서드는 모든 저수준 파싱, 텍스트 추출 및 파일 작성을 한 번에 처리하므로 복잡한 CAD 내부 구조를 직접 다룰 필요가 없습니다.
일반적인 문제 및 해결책
- File Not Found Error: DGN 파일 경로가 절대 경로이거나 실행 파일에 대해 올바르게 상대 경로인지 확인하세요.
- Permission Issues: 애플리케이션이 출력 폴더에 대한 쓰기 권한이 있는 계정으로 실행되는지 확인하세요.
- Conversion Errors:
GroupDocs.ConversionNuGet 패키지 버전이 라이선스 파일 버전과 일치하는지 확인하세요; 버전이 일치하지 않으면 런타임 오류가 발생할 수 있습니다.
실용적인 적용 사례
이 변환 기능은 다음과 같이 통합될 수 있습니다:
- Data Extraction: 분석 또는 보고를 위해 DGN 도면에서 텍스트 주석을 추출합니다.
- Interoperability: 추출된 텍스트를 GIS 시스템, BIM 데이터베이스 또는 순수 텍스트 입력만 허용하는 레거시 ERP 모듈에 전달합니다.
- Automation Workflows: CI/CD 파이프라인에 변환 단계를 삽입하여 설계 파일에서 문서를 자동으로 생성합니다.
성능 고려 사항
대량의 CAD 파일을 처리할 때 다음 팁을 기억하세요:
- Optimize Resource Usage: 메모리 사용량을 모니터링하세요; GroupDocs는 스트리밍 모드로 파일을 처리하여 수백 페이지 도면에서도 메모리 사용량을 낮게 유지합니다.
- Efficient Memory Management: 각 변환 후
Converter인스턴스를 해제하여 비관리 리소스를 즉시 해제합니다. - Batch Processing:
Parallel.ForEach를 사용해 여러 DGN 파일을 동시에 변환하되, CPU 또는 I/O 대역폭이 고갈되지 않도록 병렬 수준을 제한하세요.
리소스
- 문서
- GroupDocs Conversion 문서
- GroupDocs Conversion API 레퍼런스
- 최신 릴리스
- GroupDocs.Conversion 구매
- GroupDocs Conversion 무료 체험
- 임시 라이선스 신청
- GroupDocs 포럼
결론
축하합니다! **create output folder C#**를 수행하고 DGN 파일을 로드하여 GroupDocs.Conversion .NET을 사용해 TXT로 변환하는 방법을 배웠습니다. 이러한 단계를 애플리케이션에 통합하면 데이터 추출을 간소화하고, 상호 운용성을 향상시키며, CAD 중심 워크플로우의 전반적인 생산성을 높일 수 있습니다.
DGN → PDF 또는 DGN → DOCX와 같은 추가 형식을 탐색하려면 TxtConvertOptions를 해당 옵션 클래스로 교체하면 됩니다. GroupDocs 제품군은 50개 이상의 파일 유형을 포괄하는 통합 API를 제공하므로 모든 엔지니어링 문서에 대해 단일하고 유지 관리 가능한 변환 엔진을 구축할 수 있습니다.
자주 묻는 질문
Q: GroupDocs.Conversion이 지원하는 파일 형식은 무엇인가요?
A: PDF, DOCX, XLSX, DGN, DWG, DXF, TXT 등을 포함해 50개 이상의 형식을 지원합니다.
Q: DGN 파일 변환에 크기 제한이 있나요?
A: 엄격한 제한은 없으며, 성능은 사용 가능한 RAM 및 CPU에 따라 확장됩니다. 표준 서버에서는 최대 2 GB 파일도 안정적으로 변환됩니다.
Q: 출력 TXT의 텍스트 인코딩을 사용자 정의할 수 있나요?
A: 예—TxtConvertOptions의 Encoding 속성을 설정하면 됩니다(예: UTF‑8, ASCII).
Q: 프로덕션 환경에서 변환 오류를 어떻게 처리해야 하나요?
A: 변환 호출을 try‑catch 블록으로 감싸고, ConversionException 상세 정보를 로그에 기록한 뒤, 필요에 따라 대체 구성으로 재시도하십시오.
Q: 더 많은 예제와 API 레퍼런스는 어디서 찾을 수 있나요?
A: 공식 문서와 API 레퍼런스에서 풍부한 코드 샘플과 구성 가이드를 확인할 수 있습니다.
마지막 업데이트: 2026-07-06
테스트 대상: GroupDocs.Conversion .NET 25.3.0
작성자: GroupDocs