Jak przekonwertować DGN na PDF przy użyciu GroupDocs.Conversion dla .NET

Konwertowanie rysunku DGN do PDF jest powszechnym krokiem, gdy musisz udostępnić pliki CAD interesariuszom, którzy nie mają specjalistycznego oprogramowania. W tym samouczku dowiesz się jak przekonwertować dgn na pdf szybko i niezawodnie przy użyciu GroupDocs.Conversion dla .NET. Przejdziemy przez instalację, licencjonowanie i kompletny przykład kodu, a następnie pokażemy, jak zoptymalizować wydajność przy dużych rysunkach inżynieryjnych.

Szybkie odpowiedzi

Która biblioteka obsługuje konwersję? GroupDocs.Conversion for .NET.
Podstawowe wywołanie metody? converter.Convert(sourcePath, new PdfConvertOptions()).
Obsługiwane formaty CAD? Ponad 30, w tym DGN, DWG, DXF.
Maksymalny rozmiar pliku? Do 2 GB może być przetwarzany bez ładowania całego pliku do pamięci.
Wymaganie licencji? Wymagana jest ważna licencja GroupDocs do użytku produkcyjnego.

Co to jest konwersja dgn do pdf?

convert dgn to pdf to proces przekształcania pliku MicroStation DGN w format Portable Document Format (PDF), który zachowuje grafikę wektorową, warstwy, grubości linii i adnotacje. Ta konwersja umożliwia dokładne renderowanie, drukowanie i łatwą dystrybucję na dowolnej platformie, pozwalając użytkownikom bez oprogramowania CAD oglądać rysunek dokładnie tak, jak zamierzono.

Dlaczego używać GroupDocs.Conversion dla .NET?

GroupDocs.Conversion obsługuje ponad 30 formatów wejściowych i wyjściowych i może obsługiwać pliki do 2 GB, jednocześnie utrzymując zużycie pamięci poniżej 100 MB dzięki architekturze strumieniowej. Biblioteka działa na .NET Framework 4.6+, .NET Core 3.1+ i .NET 6+, co czyni ją odpowiednią dla scenariuszy desktop, web i chmury.

Wymagania wstępne

GroupDocs.Conversion for .NET (wersja 25.3.0 lub nowsza)
Środowisko programistyczne, takie jak Visual Studio 2022 lub Visual Studio Code
.NET 6 SDK zainstalowane na Twoim komputerze
Ważny plik licencji GroupDocs (wersja próbna lub komercyjna)

Wymagane biblioteki, wersje i zależności

GroupDocs.Conversion for .NET – 25.3.0
Newtonsoft.Json – wymagane do obsługi wewnętrznej konfiguracji (instalowane automatycznie jako zależność)

Wymagania dotyczące konfiguracji środowiska

Upewnij się, że środowisko uruchomieniowe .NET odpowiada docelowemu frameworkowi Twojego projektu. GroupDocs.Conversion działa na Windows, Linux i macOS.

Jak przekonwertować DGN na PDF w C#?

Klasa Converter jest podstawowym komponentem, który ładuje dokument i wykonuje konwersje formatów. PdfConvertOptions określa ustawienia wyjścia PDF, takie jak rozmiar strony i osadzanie czcionek. Załaduj źródłowy plik DGN, skonfiguruj opcje konwersji i wywołaj metodę Convert – cała operacja może być wykonana w trzech linijkach kodu. To bezpośrednie podejście gwarantuje, że warstwy, grubości linii i adnotacje tekstowe zostaną wiernie odtworzone w powstałym PDF.

// 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());

Powyższy fragment pokazuje główny przepływ pracy: utwórz instancję klasy Converter, określ lokalizację wyjścia i przekaż obiekt PdfConvertOptions. Biblioteka automatycznie wykrywa format DGN i stosuje odpowiedni silnik renderujący.

Przewodnik krok po kroku

Krok 1: Zainstaluj pakiet NuGet

Otwórz Package Manager Console w Visual Studio i uruchom:

Install-Package GroupDocs.Conversion -Version 25.3.0

Lub użyj .NET CLI, jeśli wolisz instalację z wiersza poleceń:

dotnet add package GroupDocs.Conversion --version 25.3.0

Oba polecenia dodają najnowszy stabilny pakiet GroupDocs.Conversion do Twojego projektu.

Krok 2: Dodaj licencję

Umieść plik GroupDocs.Conversion.lic w katalogu głównym projektu i zarejestruj go przy uruchamianiu aplikacji:

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

Wskazówka: Przechowuj plik licencji poza systemem kontroli wersji i wczytuj go z bezpiecznej lokalizacji w środowisku produkcyjnym.

Krok 3: Wykonaj konwersję

Użyj kodu pokazanego wcześniej. Dostosuj outputFolder i documentPath, aby wskazywały na rzeczywiste katalogi. Klasa PdfConvertOptions pozwala kontrolować rozmiar strony, orientację oraz czy osadzać czcionki.

Krok 4: Zweryfikuj wynik

Po konwersji otwórz wygenerowany PDF w dowolnym przeglądarce, aby potwierdzić, że wszystkie elementy rysunku wyświetlają się prawidłowo. W przypadku przetwarzania wsadowego, otocz wywołanie konwersji w pętlę foreach nad kolekcją plików DGN.

Częste problemy i rozwiązania

Brakujące czcionki – Upewnij się, że wymagane czcionki CAD są zainstalowane na maszynie hosta lub osadź je za pomocą PdfConvertOptions.EmbedFonts = true.
Duże pliki powodują przekroczenia czasu – Zwiększ limit czasu żądania HTTP, jeśli uruchamiasz konwersję w API webowym, lub podziel rysunek na mniejsze arkusze przed konwersją.
Nie znaleziono licencji – Zweryfikuj ścieżkę do GroupDocs.Conversion.lic i potwierdź, że plik ma uprawnienia odczytu dla uruchamianego procesu.

Najczęściej zadawane pytania

Q: Czy mogę konwertować pliki DGN chronione hasłem?
A: Tak. Podaj hasło poprzez przeciążenie konstruktora Converter, które przyjmuje obiekt LoadOptions. LoadOptions pozwala podać dodatkowe parametry, takie jak hasła, przy ładowaniu dokumentu.

Q: Czy biblioteka działa w kontenerach Linux?
A: Absolutnie. GroupDocs.Conversion dla .NET jest w pełni wieloplatformowa i działa w kontenerach Docker opartych na Alpine lub Ubuntu.

Q: Jakie wersje .NET są obsługiwane?
A: .NET Framework 4.6+, .NET Core 3.1+, .NET 5 i .NET 6 są oficjalnie wspierane.

Q: Jak obsłużyć konwersję wsadową tysięcy rysunków?
A: Użyj przetwarzania asynchronicznego z Task.WhenAll (Task.WhenAll czeka na zakończenie wielu operacji asynchronicznych) i ogranicz współbieżność, aby nie wyczerpać CPU ani pamięci.

Q: Czy istnieje sposób, aby konwertować tylko określony układ lub arkusz?
A: Tak. Ustaw PdfConvertOptions.Layouts na kolekcję zawierającą identyfikatory żądanych układów.

Podsumowanie

Masz teraz kompletny, gotowy do produkcji przewodnik, jak przekonwertować dgn na pdf przy użyciu GroupDocs.Conversion dla .NET. Postępując zgodnie z powyższymi krokami, możesz zintegrować konwersję CAD‑do‑PDF w narzędziach desktop, usługach webowych lub zautomatyzowanych pipeline’ach przy minimalnym wysiłku. Zbadaj dodatkowe opcje, takie jak znakowanie wodne, szyfrowanie i niestandardowe rozmiary stron, aby dostosować wyjście do standardów Twojej organizacji.

Ostatnia aktualizacja: 2026-06-15
Testowano z: 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 >}