Wie man DGN in PDF mit GroupDocs.Conversion für .NET konvertiert
Das Konvertieren einer DGN‑Zeichnung in ein PDF ist ein gängiger Schritt, wenn Sie CAD‑Dateien mit Stakeholdern teilen müssen, die keine spezialisierte Software besitzen. In diesem Tutorial lernen Sie wie man dgn in pdf konvertiert schnell und zuverlässig mit GroupDocs.Conversion für .NET. Wir gehen die Installation, Lizenzierung und ein vollständiges Code‑Beispiel durch und zeigen Ihnen, wie Sie die Leistung für große Konstruktionszeichnungen optimieren können.
Schnelle Antworten
- Welche Bibliothek führt die Konvertierung durch? GroupDocs.Conversion for .NET.
- Primärer Methodenaufruf?
converter.Convert(sourcePath, new PdfConvertOptions()). - Unterstützte CAD‑Formate? Über 30, einschließlich DGN, DWG, DXF.
- Maximale Dateigröße? Bis zu 2 GB können verarbeitet werden, ohne die gesamte Datei in den Speicher zu laden.
- Lizenzanforderung? Eine gültige GroupDocs‑Lizenz ist für den Produktionseinsatz erforderlich.
Was ist convert dgn to pdf?
convert dgn to pdf ist der Vorgang, eine MicroStation‑DGN‑Datei in ein Portable Document Format (PDF) zu transformieren, das Vektorgrafiken, Ebenen, Linienstärken und Anmerkungen beibehält. Diese Konvertierung ermöglicht eine genaue Darstellung, den Druck und die einfache Verteilung auf jeder Plattform, sodass Benutzer ohne CAD‑Software die Zeichnung exakt wie beabsichtigt ansehen können.
Warum GroupDocs.Conversion für .NET verwenden?
GroupDocs.Conversion unterstützt 30+ Eingabe‑ und Ausgabeformate und kann Dateien bis zu 2 GB verarbeiten, während der Speicherverbrauch dank seiner Streaming‑Architektur unter 100 MB bleibt. Die Bibliothek läuft auf .NET Framework 4.6+, .NET Core 3.1+ und .NET 6+, wodurch sie für Desktop‑, Web‑ und Cloud‑Szenarien geeignet ist.
Voraussetzungen
- GroupDocs.Conversion for .NET (Version 25.3.0 oder neuer)
- Eine Entwicklungsumgebung wie Visual Studio 2022 oder Visual Studio Code
- .NET 6 SDK auf Ihrem Rechner installiert
- Eine gültige GroupDocs‑Lizenzdatei (Testversion oder kommerziell)
Erforderliche Bibliotheken, Versionen und Abhängigkeiten
- GroupDocs.Conversion for .NET – 25.3.0
- Newtonsoft.Json – erforderlich für die interne Konfigurationsverwaltung (automatisch als Abhängigkeit installiert)
Anforderungen an die Umgebungseinrichtung
Stellen Sie sicher, dass die .NET‑Runtime mit dem Ziel‑Framework Ihres Projekts übereinstimmt. GroupDocs.Conversion funktioniert unter Windows, Linux und macOS.
Wie man DGN in PDF in C# konvertiert?
Die Klasse Converter ist die Kernkomponente, die ein Dokument lädt und Formatkonvertierungen durchführt. PdfConvertOptions gibt Einstellungen für die PDF‑Ausgabe an, wie Seitengröße und Schriftart‑Einbettung. Laden Sie die Quell‑DGN‑Datei, konfigurieren Sie die Konvertierungsoptionen und rufen Sie die Methode Convert auf – der gesamte Vorgang kann in drei Codezeilen durchgeführt werden. Dieser direkte Ansatz garantiert, dass Ebenen, Linienstärken und Textanmerkungen im resultierenden PDF exakt reproduziert werden.
// 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());
Das obige Snippet demonstriert den Kern‑Workflow: Instanziieren der Klasse Converter, Festlegen des Ausgabepfads und Übergeben eines PdfConvertOptions‑Objekts. Die Bibliothek erkennt das DGN‑Format automatisch und wendet die passende Rendering‑Engine an.
Schritt‑für‑Schritt‑Durchgang
Schritt 1: NuGet‑Paket installieren
Öffnen Sie die Package Manager Console in Visual Studio und führen Sie aus:
Install-Package GroupDocs.Conversion -Version 25.3.0
Oder verwenden Sie die .NET CLI, wenn Sie die Installation über die Befehlszeile bevorzugen:
dotnet add package GroupDocs.Conversion --version 25.3.0
Beide Befehle fügen das neueste stabile GroupDocs.Conversion‑Paket zu Ihrem Projekt hinzu.
Schritt 2: Lizenz hinzufügen
Legen Sie die Datei GroupDocs.Conversion.lic im Stammverzeichnis Ihres Projekts ab und registrieren Sie sie beim Anwendungsstart:
GroupDocs.Conversion.License license = new GroupDocs.Conversion.License();
license.SetLicense("GroupDocs.Conversion.lic");
Pro Tipp: Halten Sie die Lizenzdatei außerhalb der Versionskontrolle und laden Sie sie in der Produktion aus einem sicheren Speicherort.
Schritt 3: Konvertierung durchführen
Verwenden Sie den zuvor gezeigten Codeblock. Passen Sie outputFolder und documentPath an, damit sie auf Ihre tatsächlichen Verzeichnisse verweisen. Die Klasse PdfConvertOptions ermöglicht die Steuerung von Seitengröße, Ausrichtung und ob Schriftarten eingebettet werden sollen.
Schritt 4: Ergebnis überprüfen
Nach der Konvertierung öffnen Sie das erzeugte PDF in einem beliebigen Viewer, um zu bestätigen, dass alle Zeichnungselemente korrekt angezeigt werden. Für die Stapelverarbeitung wickeln Sie den Konvertierungsaufruf in eine foreach‑Schleife über eine Sammlung von DGN‑Dateien ein.
Häufige Probleme und Lösungen
- Fehlende Schriftarten – Stellen Sie sicher, dass die erforderlichen CAD‑Schriftarten auf dem Host‑Rechner installiert sind oder betten Sie sie über
PdfConvertOptions.EmbedFonts = trueein. - Große Dateien verursachen Timeouts – Erhöhen Sie das HTTP‑Request‑Timeout, wenn Sie die Konvertierung in einer Web‑API ausführen, oder teilen Sie die Zeichnung vor der Konvertierung in kleinere Blätter auf.
- Lizenz nicht gefunden – Überprüfen Sie den Pfad zu
GroupDocs.Conversion.licund stellen Sie sicher, dass die Datei Lese‑Rechte für den laufenden Prozess hat.
Häufig gestellte Fragen
Q: Kann ich passwortgeschützte DGN‑Dateien konvertieren?
A: Ja. Übergeben Sie das Passwort über den Converter‑Konstruktor‑Überladung, die ein LoadOptions‑Objekt akzeptiert. LoadOptions ermöglicht das Bereitstellen zusätzlicher Parameter wie Passwörter beim Laden eines Dokuments.
Q: Funktioniert die Bibliothek in Linux‑Containern?
A: Absolut. GroupDocs.Conversion für .NET ist vollständig plattformübergreifend und läuft in Docker‑Containern basierend auf Alpine oder Ubuntu.
Q: Welche .NET‑Versionen werden unterstützt?
A: .NET Framework 4.6+, .NET Core 3.1+, .NET 5 und .NET 6 werden alle offiziell unterstützt.
Q: Wie gehe ich mit der Stapelkonvertierung von tausenden Zeichnungen um?
A: Verwenden Sie asynchrone Verarbeitung mit Task.WhenAll (Task.WhenAll wartet auf den Abschluss mehrerer asynchroner Vorgänge) und begrenzen Sie die Parallelität, um eine Überlastung von CPU oder Speicher zu vermeiden.
Q: Gibt es eine Möglichkeit, nur ein bestimmtes Layout oder Blatt zu konvertieren?
A: Ja. Setzen Sie PdfConvertOptions.Layouts auf eine Sammlung, die die gewünschten Layout‑Bezeichner enthält.
Fazit
Sie haben nun eine vollständige, produktionsreife Anleitung zum convert dgn to pdf mit GroupDocs.Conversion für .NET. Durch Befolgen der obigen Schritte können Sie die CAD‑zu‑PDF‑Konvertierung in Desktop‑Tools, Web‑Services oder automatisierte Pipelines mit minimalem Aufwand integrieren. Erkunden Sie zusätzliche Optionen wie Wasserzeichen, Verschlüsselung und benutzerdefinierte Seitengrößen, um die Ausgabe an die Standards Ihrer Organisation anzupassen.
Zuletzt aktualisiert: 2026-06-15
Getestet mit: 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 >}