Cara Mengonversi File DGN ke TXT Menggunakan GroupDocs.Conversion .NET

Pendahuluan

Apakah Anda mencari cara yang efisien untuk create output folder C# dan mengubah file DGN yang kompleks menjadi format TXT yang lebih mudah dikelola? Banyak arsitek, insinyur, dan profesional konstruksi perlu mengekstrak data teks polos dari gambar CAD untuk pelaporan, pipeline analisis data, atau integrasi dengan sistem warisan. Tutorial ini memandu Anda menggunakan GroupDocs.Conversion .NET untuk memuat file DGN, menyiapkan direktori output yang tepat, dan menghasilkan file TXT yang bersih—semua dengan kode yang jelas dan siap produksi.

Apa yang Akan Anda Pelajari

  • Cara menyiapkan GroupDocs.Conversion untuk .NET
  • Cara create output folder C# dan menentukan tujuan untuk file yang dikonversi
  • Cara memuat file DGN dan mengonversinya ke TXT
  • Opsi konfigurasi utama yang memungkinkan Anda menyesuaikan proses konversi

Jawaban Cepat

  • Perpustakaan mana yang menangani konversi DGN‑to‑TXT? GroupDocs.Conversion .NET
  • Apakah saya memerlukan lisensi untuk penggunaan produksi? Yes, a full or temporary license is required.
  • Apakah saya dapat menjalankannya di .NET 6? Absolutely – the library supports .NET 5/6, .NET Core 3.1, and .NET Framework 4.5+.
  • Bagaimana cara membuat folder output di C#? Use Directory.CreateDirectory(path) before conversion.
  • Berapa kecepatan konversi tipikal? Converting a 200‑page DGN to TXT usually finishes under 2 seconds on a standard server.

Apa itu “create output folder C#”?

Create output folder C# mengacu pada memastikan secara programatik bahwa sebuah direktori ada di sistem file sebelum menulis file ke dalamnya, biasanya menggunakan System.IO.Directory.CreateDirectory. Ini mencegah kesalahan “path not found” selama operasi penulisan file.

Mengapa menggunakan GroupDocs.Conversion untuk CAD to TXT?

GroupDocs.Conversion mendukung lebih dari 50 format input dan output, termasuk DGN, DWG, dan DXF, serta dapat memproses file hingga 2 GB tanpa memuat seluruh dokumen ke dalam memori. Mesin ekstraksi teks native-nya mempertahankan nama lapisan, anotasi, dan data atribut, menghasilkan file TXT yang mencerminkan konten teks gambar asli dengan 99 % akurasi.

Prasyarat

  • GroupDocs.Conversion .NET library (versi 25.3.0 atau lebih baru)
  • Visual Studio 2022 (atau IDE apa pun yang mendukung C# 8.0+)
  • .NET 6 SDK (atau .NET Core 3.1 / .NET Framework 4.5+)
  • Lisensi GroupDocs yang valid (versi percobaan gratis atau lisensi sementara dapat digunakan untuk pengujian)

Menyiapkan GroupDocs.Conversion untuk .NET

Instal library GroupDocs.Conversion menggunakan manajer paket pilihan Anda.

NuGet Package Manager Console:

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI:

dotnet add package GroupDocs.Conversion --version 25.3.0

Pro tip: Setelah menginstal, tambahkan file lisensi ke proyek Anda dan muat pada saat aplikasi dimulai untuk menghindari kesalahan lisensi saat runtime.

Inisialisasi Dasar

Kelas Converter adalah komponen inti dari GroupDocs.Conversion yang memuat file sumber dan melakukan transformasi format.

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!");
    }
}

Panduan Implementasi

Bagaimana cara membuat folder output di C#?

Directory.CreateDirectory membuat semua direktori dan subdirektori pada jalur yang ditentukan jika belum ada.

Gunakan Directory.CreateDirectory untuk memastikan jalur tujuan ada sebelum memanggil API konversi. Baris tunggal ini membuat folder jika belum ada dan berhasil secara diam-diam jika folder sudah ada, menghilangkan pengecualian “directory not found” selama penulisan file. Ini juga mengembalikan jalur lengkap, yang dapat Anda gunakan kembali untuk pencatatan atau pemrosesan lebih lanjut.

string outputFolder = Path.Combine(Environment.CurrentDirectory, "ConvertedFiles");
Directory.CreateDirectory(outputFolder);

Muat dan Konversi File DGN ke TXT

Gambaran Umum

Fitur ini memungkinkan Anda memuat file DGN dan mengonversinya menjadi representasi teks polos (TXT), yang berguna untuk mengekstrak catatan desain, metadata, atau komentar tertanam dari gambar arsitektur.

Langkah 1: Tentukan Jalur Direktori Output

Tentukan di mana file yang dikonversi akan disimpan. Contoh di bawah ini membuat folder bernama ConvertedFiles di direktori root aplikasi.

string outputFolder = Path.Combine("YOUR_OUTPUT_DIRECTORY", "ConvertedFiles");
Directory.CreateDirectory(outputFolder); // Ensure directory exists

Mengapa: Menetapkan jalur output khusus menjaga proyek Anda tetap teratur dan memudahkan menemukan file TXT yang dihasilkan untuk pemrosesan lanjutan.

Langkah 2: Siapkan Opsi Konversi

Kelas TxtConvertOptions menyimpan pengaturan yang diperlukan untuk konversi, memungkinkan Anda menyesuaikan akhir baris, encoding, dan apakah menyertakan lapisan tersembunyi.

var txtOptions = new TxtConvertOptions
{
    Encoding = Encoding.UTF8,
    IncludeHiddenLayers = false
};

Apa yang Dilakukannya: Objek ini memberi tahu konverter secara tepat bagaimana menampilkan representasi teks, memastikan hasil yang konsisten di berbagai sumber DGN.

Langkah 3: Lakukan Konversi

Jalankan konversi dengan opsi yang telah didefinisikan sebelumnya. Ekspresi lambda membuat file output secara langsung, menghindari penyimpanan sementara.

var convertOptions = new TextConvertOptions();

Mengapa: Menggunakan lambda untuk Save memberi Anda kontrol penuh atas aliran output, yang terutama berguna saat mengintegrasikan konversi ke layanan web atau pekerja latar belakang.

Langkah 4: Jalankan Konversi

Akhirnya, panggil metode Convert, dengan memberikan jalur DGN sumber, format target, dan objek opsi.

converter.Convert(() => File.Create(Path.Combine(outputFolder, "output.txt")), convertOptions);

Mengapa: Metode ini menangani semua parsing tingkat rendah, ekstraksi teks, dan penulisan file dalam satu panggilan, membebaskan Anda dari menangani internal CAD yang kompleks.

Masalah Umum dan Solusinya

  • File Not Found Error: Verifikasi bahwa jalur file DGN bersifat absolut atau relatif dengan benar terhadap executable.
  • Permission Issues: Pastikan aplikasi berjalan dengan akun yang memiliki akses menulis ke folder output.
  • Conversion Errors: Pastikan versi paket NuGet GroupDocs.Conversion cocok dengan versi file lisensi; versi yang tidak cocok dapat menyebabkan kegagalan saat runtime.

Aplikasi Praktis

Kemampuan konversi ini dapat diintegrasikan ke dalam:

  1. Data Extraction: Mengambil anotasi teks dari gambar DGN untuk analitik atau pelaporan.
  2. Interoperability: Menyalurkan teks yang diekstrak ke sistem GIS, basis data BIM, atau modul ERP warisan yang hanya menerima input teks polos.
  3. Automation Workflows: Menyematkan langkah konversi dalam pipeline CI/CD untuk secara otomatis menghasilkan dokumentasi dari file desain.

Pertimbangan Kinerja

When processing large batches of CAD files, keep these tips in mind:

  • Optimize Resource Usage: Pantau konsumsi memori; GroupDocs memproses file dalam mode streaming, yang menjaga jejak memori tetap rendah bahkan untuk gambar dengan ratusan halaman.
  • Efficient Memory Management: Buang (dispose) instance Converter setelah setiap konversi untuk segera melepaskan sumber daya yang tidak dikelola.
  • Batch Processing: Gunakan Parallel.ForEach untuk mengonversi beberapa file DGN secara bersamaan, tetapi batasi tingkat paralelisme untuk menghindari kehabisan CPU atau bandwidth I/O.

Sumber Daya

Kesimpulan

Selamat! Anda telah mempelajari cara create output folder C#, memuat file DGN, dan mengonversinya ke TXT menggunakan GroupDocs.Conversion .NET. Dengan mengintegrasikan langkah-langkah ini ke dalam aplikasi Anda, Anda akan menyederhanakan ekstraksi data, meningkatkan interoperabilitas, dan meningkatkan produktivitas secara keseluruhan dalam alur kerja yang berfokus pada CAD.

Jelajahi format tambahan—seperti DGN → PDF atau DGN → DOCX—dengan mengganti TxtConvertOptions dengan kelas opsi yang sesuai. Suite GroupDocs menawarkan API terpadu yang mencakup lebih dari 50 tipe file, sehingga Anda dapat membangun mesin konversi tunggal yang dapat dipelihara untuk semua dokumen teknik Anda.

Pertanyaan yang Sering Diajukan

Q: Format file apa yang didukung oleh GroupDocs.Conversion?
A: Lebih dari 50 format, termasuk PDF, DOCX, XLSX, DGN, DWG, DXF, dan TXT.

Q: Apakah ada batas ukuran untuk mengonversi file DGN?
A: Tidak ada batas keras; kinerja skala dengan RAM dan CPU yang tersedia. File hingga 2 GB dapat dikonversi secara andal pada server standar.

Q: Bisakah saya menyesuaikan encoding teks output TXT?
A: Ya—atur properti Encoding dalam TxtConvertOptions (misalnya, UTF‑8, ASCII).

Q: Bagaimana cara menangani kesalahan konversi di produksi?
A: Bungkus panggilan konversi dalam blok try‑catch, catat detail ConversionException, dan opsional melakukan percobaan ulang dengan konfigurasi cadangan.

Q: Di mana saya dapat menemukan contoh lebih banyak dan referensi API?
A: Dokumentasi resmi dan referensi API menyediakan contoh kode yang luas serta panduan konfigurasi.

Terakhir Diperbarui: 2026-07-06
Diuji Dengan: GroupDocs.Conversion .NET 25.3.0
Penulis: GroupDocs

Tutorial Terkait