Cara Mengonversi DGN ke PDF dengan GroupDocs.Conversion untuk .NET

Mengonversi gambar DGN ke PDF adalah langkah umum ketika Anda perlu berbagi file CAD dengan pemangku kepentingan yang tidak memiliki perangkat lunak khusus. Dalam tutorial ini Anda akan belajar how to convert dgn to pdf dengan cepat dan dapat diandalkan menggunakan GroupDocs.Conversion untuk .NET. Kami akan membahas instalasi, lisensi, dan contoh kode lengkap, kemudian menunjukkan cara mengoptimalkan kinerja untuk gambar teknik berukuran besar.

Jawaban Cepat

  • Perpustakaan mana yang menangani konversi? GroupDocs.Conversion untuk .NET.
  • Pemanggilan metode utama? converter.Convert(sourcePath, new PdfConvertOptions()).
  • Format CAD yang didukung? Lebih dari 30, termasuk DGN, DWG, DXF.
  • Ukuran file maksimum? Hingga 2 GB dapat diproses tanpa memuat seluruh file ke memori.
  • Persyaratan lisensi? Lisensi GroupDocs yang valid diperlukan untuk penggunaan produksi.

Apa itu convert dgn to pdf?

convert dgn to pdf adalah proses mengubah file MicroStation DGN menjadi Portable Document Format (PDF) yang mempertahankan grafik vektor, lapisan, ketebalan garis, dan anotasi. Konversi ini memungkinkan rendering yang akurat, pencetakan, dan distribusi mudah di semua platform, memungkinkan pengguna tanpa perangkat lunak CAD melihat gambar persis seperti yang dimaksud.

Mengapa Menggunakan GroupDocs.Conversion untuk .NET?

GroupDocs.Conversion mendukung 30+ format input dan output dan dapat menangani file hingga 2 GB sambil menjaga penggunaan memori di bawah 100 MB berkat arsitektur streamingnya. Perpustakaan ini berjalan pada .NET Framework 4.6+, .NET Core 3.1+, dan .NET 6+, menjadikannya cocok untuk skenario desktop, web, dan cloud.

Prasyarat

  • GroupDocs.Conversion untuk .NET (versi 25.3.0 atau lebih baru)
  • Lingkungan pengembangan seperti Visual Studio 2022 atau Visual Studio Code
  • .NET 6 SDK terpasang di mesin Anda
  • File lisensi GroupDocs yang valid (percobaan atau komersial)

Perpustakaan, Versi, dan Dependensi yang Diperlukan

  • GroupDocs.Conversion untuk .NET – 25.3.0
  • Newtonsoft.Json – diperlukan untuk penanganan konfigurasi internal (dipasang secara otomatis sebagai dependensi)

Persyaratan Penyiapan Lingkungan

Pastikan runtime .NET cocok dengan kerangka target proyek Anda. GroupDocs.Conversion bekerja pada Windows, Linux, dan macOS.

Cara Mengonversi DGN ke PDF dalam C#?

Kelas Converter adalah komponen inti yang memuat dokumen dan melakukan konversi format. PdfConvertOptions menentukan pengaturan output PDF seperti ukuran halaman dan penyematan font. Muat file DGN sumber, konfigurasikan opsi konversi, dan panggil metode Convert – seluruh operasi dapat dilakukan dalam tiga baris kode. Pendekatan langsung ini menjamin bahwa lapisan, ketebalan garis, dan anotasi teks direproduksi secara akurat dalam PDF yang dihasilkan.

// Define paths
string outputFolder = Path.Combine(@"YOUR_OUTPUT_DIRECTORY");
string documentPath = Path.Combine(@"YOUR_DOCUMENT_DIRECTORY\sample.dgn");

// Initialize the converter and perform conversion
var converter = new GroupDocs.Conversion.Converter(documentPath);
converter.Convert(outputFolder, new GroupDocs.Conversion.Options.PdfConvertOptions());

Potongan kode di atas menunjukkan core workflow: membuat instance kelas Converter, menentukan lokasi output, dan melewatkan objek PdfConvertOptions. Perpustakaan secara otomatis mendeteksi format DGN dan menerapkan mesin rendering yang sesuai.

Panduan Langkah‑per‑Langkah

Langkah 1: Instal Paket NuGet

Buka Package Manager Console di Visual Studio dan jalankan:

Install-Package GroupDocs.Conversion -Version 25.3.0

Atau gunakan .NET CLI jika Anda lebih suka instalasi melalui baris perintah:

dotnet add package GroupDocs.Conversion --version 25.3.0

Kedua perintah tersebut menambahkan paket GroupDocs.Conversion stabil terbaru ke proyek Anda.

Langkah 2: Tambahkan Lisensi Anda

Letakkan file GroupDocs.Conversion.lic di root proyek Anda dan daftarkan pada saat aplikasi dimulai:

GroupDocs.Conversion.License license = new GroupDocs.Conversion.License();
license.SetLicense("GroupDocs.Conversion.lic");

Pro tip: Simpan file lisensi di luar kontrol sumber dan muat dari lokasi yang aman dalam produksi.

Langkah 3: Lakukan Konversi

Gunakan blok kode yang ditampilkan sebelumnya. Sesuaikan outputFolder dan documentPath untuk mengarah ke direktori Anda yang sebenarnya. Kelas PdfConvertOptions memungkinkan Anda mengontrol ukuran halaman, orientasi, dan apakah menyematkan font.

Langkah 4: Verifikasi Hasil

Setelah konversi, buka PDF yang dihasilkan di penampil apa pun untuk memastikan semua elemen gambar muncul dengan benar. Untuk pemrosesan batch, bungkus panggilan konversi dalam loop foreach atas koleksi file DGN.

Masalah Umum dan Solusinya

  • Missing fonts – Pastikan font CAD yang diperlukan terpasang di mesin host atau sematkan melalui PdfConvertOptions.EmbedFonts = true.
  • Large files cause timeouts – Tingkatkan batas waktu permintaan HTTP jika Anda menjalankan konversi dalam web API, atau bagi gambar menjadi lembaran lebih kecil sebelum konversi.
  • License not found – Verifikasi jalur ke GroupDocs.Conversion.lic dan pastikan file memiliki izin baca untuk proses yang berjalan.

Pertanyaan yang Sering Diajukan

Q: Bisakah saya mengonversi file DGN yang dilindungi kata sandi?
A: Ya. Berikan kata sandi melalui overload konstruktor Converter yang menerima objek LoadOptions. LoadOptions memungkinkan Anda menyediakan parameter tambahan seperti kata sandi saat memuat dokumen.

Q: Apakah perpustakaan ini bekerja pada kontainer Linux?
A: Tentu saja. GroupDocs.Conversion untuk .NET sepenuhnya lintas‑platform dan berjalan di kontainer Docker berbasis Alpine atau Ubuntu.

Q: Versi .NET apa yang didukung?
A: .NET Framework 4.6+, .NET Core 3.1+, .NET 5, dan .NET 6 semuanya didukung secara resmi.

Q: Bagaimana cara menangani konversi batch ribuan gambar?
A: Gunakan pemrosesan asynchronous dengan Task.WhenAll (Task.WhenAll menunggu beberapa operasi asynchronous selesai) dan batasi konkurensi untuk menghindari kehabisan CPU atau memori.

Q: Apakah ada cara untuk mengonversi hanya tata letak atau lembar tertentu?
A: Ya. Atur PdfConvertOptions.Layouts ke koleksi yang berisi pengidentifikasi tata letak yang diinginkan.

Kesimpulan

Anda kini memiliki panduan lengkap yang siap produksi untuk convert dgn to pdf menggunakan GroupDocs.Conversion untuk .NET. Dengan mengikuti langkah-langkah di atas, Anda dapat mengintegrasikan konversi CAD‑ke‑PDF ke dalam alat desktop, layanan web, atau pipeline otomatis dengan upaya minimal. Jelajahi opsi tambahan seperti watermark, enkripsi, dan penyesuaian ukuran halaman untuk menyesuaikan output dengan standar organisasi Anda.

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

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

// Initialize converter object
groupdocsConversion = new Converter("path/to/your/file.dgn");

// Convert to PDF settings
PdfConvertOptions options = new PdfConvertOptions();

{< /blocks/products/pf/tutorial-page-section >} {< /blocks/products/pf/main-container >} {< /blocks/products/pf/main-wrap-class >} {< blocks/products/products-backtop-button >}

Tutorial Terkait