Wie man DGN-Dateien in TXT mit GroupDocs.Conversion .NET konvertiert

Einleitung

Suchen Sie nach einer effizienten Möglichkeit, create output folder C# zu erstellen und komplexe DGN-Dateien in ein handlicheres TXT-Format zu transformieren? Viele Architekten, Ingenieure und Bauprofis müssen reine Textdaten aus CAD-Zeichnungen für Berichte, Datenanalyse‑Pipelines oder die Integration in Altsysteme extrahieren. Dieses Tutorial führt Sie durch die Verwendung von GroupDocs.Conversion .NET, um eine DGN-Datei zu laden, ein geeignetes Ausgabeverzeichnis einzurichten und eine saubere TXT‑Datei zu erzeugen – alles mit klarem, produktionsreifem Code.

Was Sie lernen werden

  • Wie man GroupDocs.Conversion für .NET einrichtet
  • Wie man create output folder C# erstellt und das Ziel für konvertierte Dateien angibt
  • Wie man eine DGN-Datei lädt und in TXT konvertiert
  • Wichtige Konfigurationsoptionen, die es ermöglichen, den Konvertierungsprozess fein abzustimmen

Schnelle Antworten

  • Welche Bibliothek übernimmt die DGN‑zu‑TXT-Konvertierung? GroupDocs.Conversion .NET
  • Benötige ich eine Lizenz für den Produktionseinsatz? Ja, eine vollständige oder temporäre Lizenz ist erforderlich.
  • Kann ich das auf .NET 6 ausführen? Absolut – die Bibliothek unterstützt .NET 5/6, .NET Core 3.1 und .NET Framework 4.5+.
  • Wie erstelle ich den Ausgabepfad in C#? Verwenden Sie Directory.CreateDirectory(path) vor der Konvertierung.
  • Wie hoch ist die typische Konvertierungsgeschwindigkeit? Das Konvertieren einer 200‑seitigen DGN zu TXT dauert in der Regel weniger als 2 Sekunden auf einem Standard‑Server.

Was bedeutet “create output folder C#”?

Create output folder C# bezieht sich darauf, programmgesteuert sicherzustellen, dass ein Verzeichnis im Dateisystem existiert, bevor Dateien dorthin geschrieben werden, typischerweise mit System.IO.Directory.CreateDirectory. Dies verhindert „Pfad nicht gefunden“-Fehler während Datei‑Schreibvorgängen.

Warum GroupDocs.Conversion für CAD zu TXT verwenden?

GroupDocs.Conversion unterstützt 50+ Eingabe‑ und Ausgabeformate, darunter DGN, DWG und DXF, und kann Dateien bis zu 2 GB verarbeiten, ohne das gesamte Dokument in den Speicher zu laden. Seine native Text‑Extraktions‑Engine bewahrt Ebenennamen, Anmerkungen und Attributdaten und liefert eine TXT‑Datei, die den textuellen Inhalt der Originalzeichnung mit 99 % Genauigkeit widerspiegelt.

Voraussetzungen

  • GroupDocs.Conversion .NET Bibliothek (Version 25.3.0 oder höher)
  • Visual Studio 2022 (oder jede IDE, die C# 8.0+ unterstützt)
  • .NET 6 SDK (oder .NET Core 3.1 / .NET Framework 4.5+)
  • Eine gültige GroupDocs‑Lizenz (Kostenlose Testversion oder temporäre Lizenz funktioniert für Tests)

Einrichten von GroupDocs.Conversion für .NET

Installieren Sie die GroupDocs.Conversion‑Bibliothek mit dem Paketmanager Ihrer Wahl.

NuGet Package Manager Console:

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI:

dotnet add package GroupDocs.Conversion --version 25.3.0

Profi‑Tipp: Nach der Installation fügen Sie die Lizenzdatei zu Ihrem Projekt hinzu und laden sie beim Anwendungsstart, um Laufzeit‑Lizenzierungsfehler zu vermeiden.

Grundlegende Initialisierung

Die Converter‑Klasse ist die Kernkomponente von GroupDocs.Conversion, die Quelldateien lädt und Format‑Transformationen durchführt.

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

Implementierungs‑Leitfaden

Wie erstelle ich einen Ausgabepfad in C#?

Directory.CreateDirectory erstellt alle Verzeichnisse und Unterverzeichnisse im angegebenen Pfad, falls sie noch nicht existieren.

Verwenden Sie Directory.CreateDirectory, um sicherzustellen, dass der Zielpfad vor dem Aufruf der Konvertierungs‑API existiert. Diese einzelne Zeile erstellt den Ordner, falls er fehlt, und schlägt stillschweigend fehl, wenn der Ordner bereits existiert, wodurch „Verzeichnis nicht gefunden“-Ausnahmen beim Schreiben von Dateien vermieden werden. Sie gibt zudem den vollständigen Pfad zurück, den Sie für Protokollierung oder weitere Verarbeitung wiederverwenden können.

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

Laden und Konvertieren einer DGN-Datei zu TXT

Übersicht

Diese Funktion ermöglicht es Ihnen, eine DGN-Datei zu laden und in eine Nur‑Text‑ (TXT‑) Darstellung zu konvertieren, was praktisch ist, um Design‑Notizen, Metadaten oder eingebettete Kommentare aus architektonischen Zeichnungen zu extrahieren.

Schritt 1: Definieren Sie den Ausgabeverzeichnis‑Pfad

Geben Sie an, wo Ihre konvertierten Dateien gespeichert werden sollen. Das untenstehende Beispiel erstellt einen Ordner namens ConvertedFiles im Stammverzeichnis der Anwendung.

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

Warum: Das Definieren eines dedizierten Ausgabepfads hält Ihr Projekt organisiert und erleichtert das Auffinden der erzeugten TXT‑Dateien für nachgelagerte Verarbeitung.

Schritt 2: Konfigurationsoptionen einrichten

Die TxtConvertOptions‑Klasse enthält die für die Konvertierung erforderlichen Einstellungen und ermöglicht es Ihnen, Zeilenenden, Kodierung und ob versteckte Ebenen einbezogen werden sollen, anzupassen.

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

Was es bewirkt: Dieses Objekt teilt dem Konverter exakt mit, wie die Textdarstellung zu rendern ist, und sorgt für konsistente Ergebnisse über verschiedene DGN‑Quellen hinweg.

Schritt 3: Durchführung der Konvertierung

Führen Sie die Konvertierung mit den zuvor definierten Optionen aus. Der Lambda‑Ausdruck erstellt die Ausgabedatei on‑the‑fly und vermeidet temporären Speicher.

var convertOptions = new TextConvertOptions();

Warum: Die Verwendung eines Lambdas für Save gibt Ihnen die volle Kontrolle über den Ausgabestream, was besonders nützlich ist, wenn die Konvertierung in Web‑Services oder Hintergrund‑Worker integriert wird.

Schritt 4: Ausführen der Konvertierung

Rufen Sie schließlich die Convert‑Methode auf und übergeben Sie den Quell‑DGN‑Pfad, das Zielformat und das Options‑Objekt.

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

Warum: Die Methode übernimmt das gesamte Low‑Level‑Parsing, die Textextraktion und das Schreiben der Datei in einem einzigen Aufruf, sodass Sie sich nicht mit den komplexen CAD‑Interna befassen müssen.

Häufige Probleme und Lösungen

  • Datei nicht gefunden‑Fehler: Stellen Sie sicher, dass der DGN‑Dateipfad absolut oder korrekt relativ zur ausführbaren Datei ist.
  • Berechtigungsprobleme: Vergewissern Sie sich, dass die Anwendung unter einem Konto mit Schreibzugriff auf den Ausgabepfad läuft.
  • Konvertierungsfehler: Prüfen Sie, ob die Version des GroupDocs.Conversion‑NuGet‑Pakets mit der Lizenzdateiversion übereinstimmt; Versionskonflikte können Laufzeitfehler verursachen.

Praktische Anwendungen

Diese Konvertierungsfunktion kann integriert werden in:

  1. Datenextraktion: Textuelle Anmerkungen aus DGN‑Zeichnungen für Analysen oder Berichte extrahieren.
  2. Interoperabilität: Extrahierten Text in GIS‑Systeme, BIM‑Datenbanken oder alte ERP‑Module einspeisen, die nur Nur‑Text‑Eingaben akzeptieren.
  3. Automatisierungs‑Workflows: Den Konvertierungsschritt in CI/CD‑Pipelines einbetten, um automatisch Dokumentation aus Design‑Dateien zu erzeugen.

Leistungsüberlegungen

Bei der Verarbeitung großer Stapel von CAD‑Dateien sollten Sie diese Tipps beachten:

  • Ressourcennutzung optimieren: Überwachen Sie den Speicherverbrauch; GroupDocs verarbeitet Dateien im Streaming‑Modus, wodurch der Speicherverbrauch selbst bei mehrhundertseitigen Zeichnungen gering bleibt.
  • Effizientes Speichermanagement: Entsorgen Sie die Converter‑Instanz nach jeder Konvertierung, um nicht verwaltete Ressourcen umgehend freizugeben.
  • Stapelverarbeitung: Verwenden Sie Parallel.ForEach, um mehrere DGN‑Dateien gleichzeitig zu konvertieren, aber begrenzen Sie den Parallelitätsgrad, um eine Überlastung von CPU oder I/O‑Bandbreite zu vermeiden.

Ressourcen

Fazit

Herzlichen Glückwunsch! Sie haben gelernt, wie man create output folder C# erstellt, eine DGN‑Datei lädt und sie mit GroupDocs.Conversion .NET in TXT konvertiert. Durch die Integration dieser Schritte in Ihre Anwendungen optimieren Sie die Datenextraktion, verbessern die Interoperabilität und steigern die Gesamteffizienz Ihrer CAD‑zentrierten Arbeitsabläufe.

Entdecken Sie weitere Formate – beispielsweise DGN → PDF oder DGN → DOCX – indem Sie die TxtConvertOptions durch die passende Optionsklasse ersetzen. Die GroupDocs‑Suite bietet eine einheitliche API, die über 50 Dateitypen abdeckt, sodass Sie eine einzige, wartbare Konvertierungs‑Engine für all Ihre technischen Dokumente erstellen können.

Häufig gestellte Fragen

F: Welche Dateiformate unterstützt GroupDocs.Conversion?
A: Über 50 Formate, darunter PDF, DOCX, XLSX, DGN, DWG, DXF und TXT.

F: Gibt es ein Größenlimit für die Konvertierung von DGN‑Dateien?
A: Kein festes Limit; die Leistung skaliert mit verfügbarem RAM und CPU. Dateien bis zu 2 GB konvertieren zuverlässig auf Standard‑Servern.

F: Kann ich die Textkodierung der Ausgabedatei TXT anpassen?
A: Ja – setzen Sie die Encoding‑Eigenschaft in TxtConvertOptions (z. B. UTF‑8, ASCII).

F: Wie sollte ich Konvertierungsfehler in der Produktion behandeln?
A: Umgeben Sie den Konvertierungsaufruf mit einem try‑catch‑Block, protokollieren Sie Details der ConversionException und versuchen Sie optional mit einer Ersatzkonfiguration erneut.

F: Wo finde ich weitere Beispiele und API‑Referenzen?
A: Die offizielle Dokumentation und API‑Referenz bieten umfangreiche Code‑Beispiele und Konfigurationsanleitungen.

Zuletzt aktualisiert: 2026-07-06
Getestet mit: GroupDocs.Conversion .NET 25.3.0
Autor: GroupDocs

Verwandte Tutorials