Jak převést DGN na PDF pomocí GroupDocs.Conversion pro .NET
Převod výkresu DGN do PDF je běžný krok, když potřebujete sdílet CAD soubory se zainteresovanými stranami, které nemají specializovaný software. V tomto tutoriálu se naučíte jak převést dgn na pdf rychle a spolehlivě pomocí GroupDocs.Conversion pro .NET. Provedeme vás instalací, licencováním a kompletním příkladem kódu a poté vám ukážeme, jak optimalizovat výkon pro velké inženýrské výkresy.
Rychlé odpovědi
- Která knihovna provádí převod? GroupDocs.Conversion for .NET.
- Hlavní volání metody?
converter.Convert(sourcePath, new PdfConvertOptions()). - Podporované formáty CAD? Více než 30, včetně DGN, DWG, DXF.
- Maximální velikost souboru? Až 2 GB lze zpracovat bez načtení celého souboru do paměti.
- Požadavek na licenci? Pro produkční použití je potřeba platná licence GroupDocs.
Co je převod dgn na pdf?
convert dgn to pdf je proces transformace souboru MicroStation DGN do formátu Portable Document Format (PDF), který zachovává vektorovou grafiku, vrstvy, tloušťky čar a anotace. Tento převod umožňuje přesné vykreslení, tisk a snadnou distribuci na jakékoli platformě, což uživatelům bez CAD softwaru umožňuje zobrazit výkres přesně tak, jak byl zamýšlen.
Proč používat GroupDocs.Conversion pro .NET?
GroupDocs.Conversion podporuje 30+ vstupních a výstupních formátů a může zpracovat soubory až do 2 GB, přičemž využití paměti zůstává pod 100 MB díky své streamovací architektuře. Knihovna běží na .NET Framework 4.6+, .NET Core 3.1+ a .NET 6+, což ji činí vhodnou pro desktopové, webové i cloudové scénáře.
Požadavky
- GroupDocs.Conversion for .NET (verze 25.3.0 nebo novější)
- Vývojové prostředí jako Visual Studio 2022 nebo Visual Studio Code
- .NET 6 SDK nainstalovaný na vašem počítači
- Platný licenční soubor GroupDocs (zkušební nebo komerční)
Požadované knihovny, verze a závislosti
- GroupDocs.Conversion for .NET – 25.3.0
- Newtonsoft.Json – vyžadováno pro interní zpracování konfigurace (instaluje se automaticky jako závislost)
Požadavky na nastavení prostředí
Ujistěte se, že .NET runtime odpovídá cílovému frameworku vašeho projektu. GroupDocs.Conversion funguje na Windows, Linuxu a macOS.
Jak převést DGN na PDF v C#?
Třída Converter je hlavní komponentou, která načítá dokument a provádí konverzi formátů. PdfConvertOptions určuje nastavení výstupu PDF, jako je velikost stránky a vložení fontů. Načtěte zdrojový soubor DGN, nakonfigurujte možnosti konverze a zavolejte metodu Convert – celá operace může být provedena ve třech řádcích kódu. Tento přímý přístup zaručuje, že vrstvy, tloušťky čar a textové anotace jsou ve výsledném PDF věrně reprodukovány.
// 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());
Ukázka výše demonstruje hlavní pracovní postup: vytvořte instanci třídy Converter, určete výstupní umístění a předáte objekt PdfConvertOptions. Knihovna automaticky detekuje formát DGN a použije odpovídající renderovací engine.
Postup krok za krokem
Krok 1: Instalace NuGet balíčku
Otevřete Package Manager Console ve Visual Studio a spusťte:
Install-Package GroupDocs.Conversion -Version 25.3.0
Nebo použijte .NET CLI, pokud dáváte přednost instalaci z příkazové řádky:
dotnet add package GroupDocs.Conversion --version 25.3.0
Oba příkazy přidají nejnovější stabilní balíček GroupDocs.Conversion do vašeho projektu.
Krok 2: Přidání licence
Umístěte soubor GroupDocs.Conversion.lic do kořenového adresáře vašeho projektu a zaregistrujte jej při spuštění aplikace:
GroupDocs.Conversion.License license = new GroupDocs.Conversion.License();
license.SetLicense("GroupDocs.Conversion.lic");
Tip: Uchovávejte licenční soubor mimo správu verzí a načítejte jej z bezpečného umístění v produkci.
Krok 3: Provedení konverze
Použijte kódový blok uvedený výše. Upravit outputFolder a documentPath, aby ukazovaly na vaše skutečné adresáře. Třída PdfConvertOptions vám umožňuje řídit velikost stránky, orientaci a zda vložit fonty.
Krok 4: Ověření výsledku
Po konverzi otevřete vygenerovaný PDF v libovolném prohlížeči a ověřte, že všechny prvky výkresu jsou zobrazeny správně. Pro hromadné zpracování zabalte volání konverze do smyčky foreach nad kolekcí souborů DGN.
Časté problémy a řešení
- Chybějící fonty – Ujistěte se, že požadované CAD fonty jsou nainstalovány na hostitelském počítači, nebo je vložte pomocí
PdfConvertOptions.EmbedFonts = true. - Velké soubory způsobují časové limity – Zvyšte timeout HTTP požadavku, pokud provádíte konverzi ve webovém API, nebo rozdělte výkres na menší listy před konverzí.
- Licence nebyla nalezena – Ověřte cestu k souboru
GroupDocs.Conversion.lica potvrďte, že soubor má oprávnění ke čtení pro běžící proces.
Často kladené otázky
Q: Mohu převést DGN soubory chráněné heslem?
A: Ano. Heslo předáte přes přetížený konstruktor Converter, který přijímá objekt LoadOptions. LoadOptions vám umožňuje poskytnout další parametry, jako jsou hesla, při načítání dokumentu.
Q: Funguje knihovna v Linuxových kontejnerech?
A: Rozhodně. GroupDocs.Conversion pro .NET je plně multiplatformní a běží v Docker kontejnerech založených na Alpine nebo Ubuntu.
Q: Jaké verze .NET jsou podporovány?
A: .NET Framework 4.6+, .NET Core 3.1+, .NET 5 a .NET 6 jsou všechny oficiálně podporovány.
Q: Jak zvládnout hromadnou konverzi tisíců výkresů?
A: Použijte asynchronní zpracování s Task.WhenAll (Task.WhenAll čeká na dokončení více asynchronních operací) a omezte souběžnost, aby nedošlo k vyčerpání CPU nebo paměti.
Q: Existuje způsob, jak převést pouze konkrétní rozvržení nebo list?
A: Ano. Nastavte PdfConvertOptions.Layouts na kolekci obsahující požadované identifikátory rozvržení.
Závěr
Nyní máte kompletní, připravený průvodce pro převod dgn na pdf pomocí GroupDocs.Conversion pro .NET. Dodržením výše uvedených kroků můžete integrovat převod CAD‑na‑PDF do desktopových nástrojů, webových služeb nebo automatizovaných pipeline s minimálním úsilím. Prozkoumejte další možnosti, jako je vodoznakování, šifrování a vlastní nastavení velikosti stránky, abyste výstup přizpůsobili standardům vaší organizace.
Poslední aktualizace: 2026-06-15
Testováno s: GroupDocs.Conversion 25.3.0 for .NET
Autor: 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 >}