Hoe DGN-bestanden omzetten naar TXT met GroupDocs.Conversion .NET

Inleiding

Zoek je een efficiënte manier om create output folder C# te gebruiken en complexe DGN‑bestanden om te zetten naar een beter beheersbaar TXT‑formaat? Veel architecten, ingenieurs en bouwprofessionals moeten platte‑tekstgegevens uit CAD‑tekeningen extraheren voor rapportage, data‑analyse‑pijplijnen of integratie met legacy‑systemen. Deze tutorial leidt je stap voor stap door het gebruik van GroupDocs.Conversion .NET om een DGN‑bestand te laden, een juiste uitvoermap in te stellen en een schone TXT‑file te genereren — allemaal met duidelijke, productie‑klare code.

Wat je leert

  • Hoe je GroupDocs.Conversion voor .NET instelt
  • Hoe je create output folder C# gebruikt en de bestemming voor geconverteerde bestanden opgeeft
  • Hoe je een DGN‑bestand laadt en converteert naar TXT
  • Belangrijke configuratie‑opties die je in staat stellen het conversieproces fijn af te stemmen

Snelle Antwoorden

  • Welke bibliotheek verwerkt DGN‑naar‑TXT conversie? GroupDocs.Conversion .NET
  • Heb ik een licentie nodig voor productiegebruik? Ja, een volledige of tijdelijke licentie is vereist.
  • Kan ik dit draaien op .NET 6? Absoluut – de bibliotheek ondersteunt .NET 5/6, .NET Core 3.1 en .NET Framework 4.5+.
  • Hoe maak ik de outputmap in C#? Gebruik Directory.CreateDirectory(path) vóór de conversie.
  • Wat is de typische conversiesnelheid? Het converteren van een DGN van 200 pagina’s naar TXT voltooit meestal binnen 2 seconden op een standaard server.

Wat is “create output folder C#”?

Create output folder C# verwijst naar het programmatisch zorgen dat een map bestaat op het bestandssysteem voordat er bestanden naar worden geschreven, meestal met System.IO.Directory.CreateDirectory. Dit voorkomt “pad niet gevonden” fouten tijdens bestands‑schrijfbewerkingen.

Waarom GroupDocs.Conversion gebruiken voor CAD naar TXT?

GroupDocs.Conversion ondersteunt meer dan 50 invoer‑ en uitvoerformaten, waaronder DGN, DWG en DXF, en kan bestanden tot 2 GB verwerken zonder het volledige document in het geheugen te laden. De native tekst‑extractie‑engine behoudt laagnaam, annotaties en attribuutgegevens, en levert een TXT‑bestand dat de tekstuele inhoud van de oorspronkelijke tekening weergeeft met 99 % nauwkeurigheid.

Vereisten

  • GroupDocs.Conversion .NET bibliotheek (versie 25.3.0 of later)
  • Visual Studio 2022 (of een IDE die C# 8.0+ ondersteunt)
  • .NET 6 SDK (of .NET Core 3.1 / .NET Framework 4.5+)
  • Een geldige GroupDocs‑licentie (gratis proefversie of tijdelijke licentie werkt voor testen)

GroupDocs.Conversion instellen voor .NET

Installeer de GroupDocs.Conversion‑bibliotheek met de pakketbeheerder van jouw keuze.

NuGet Package Manager Console:

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI:

dotnet add package GroupDocs.Conversion --version 25.3.0

Pro tip: Voeg na de installatie het licentiebestand toe aan je project en laad het bij het starten van de applicatie om runtime‑licentie‑fouten te voorkomen.

Basisinitialisatie

De Converter‑klasse is de kerncomponent van GroupDocs.Conversion die bronbestanden laadt en formaat‑transformaties uitvoert.

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

Implementatiegids

Hoe maak ik een outputmap in C#?

Directory.CreateDirectory maakt alle mappen en submappen aan in het opgegeven pad als ze nog niet bestaan.

Gebruik Directory.CreateDirectory om te garanderen dat het bestemmingspad bestaat voordat de conversie‑API wordt aangeroepen. Deze enkele regel maakt de map aan als deze ontbreekt en slaagt stilletjes als de map al bestaat, waardoor “directory not found”‑exceptions tijdens het schrijven van bestanden worden voorkomen. Het retourneert ook het volledige pad, dat je kunt hergebruiken voor logging of verdere verwerking.

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

Load and Convert DGN File to TXT

Overzicht

Deze functionaliteit stelt je in staat een DGN‑bestand te laden en te converteren naar een platte‑tekst (TXT) weergave, wat handig is voor het extraheren van ontwerpaantekeningen, metadata of ingebedde commentaren uit architecturale tekeningen.

Stap 1: Definieer het pad van de uitvoermap

Geef op waar je geconverteerde bestanden worden opgeslagen. Het voorbeeld hieronder maakt een map genaamd ConvertedFiles in de hoofdmap van de applicatie.

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

Waarom: Het definiëren van een dedicated output‑pad houdt je project georganiseerd en maakt het makkelijker om gegenereerde TXT‑bestanden te vinden voor downstream‑verwerking.

Stap 2: Conversie‑opties instellen

De TxtConvertOptions‑klasse bevat de instellingen die nodig zijn voor de conversie, waardoor je regelafbrekingen, codering en of verborgen lagen moeten worden opgenomen kunt aanpassen.

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

Wat het doet: Dit object vertelt de converter precies hoe de tekstuele weergave moet worden gegenereerd, waardoor consistente resultaten over verschillende DGN‑bronnen worden gegarandeerd.

Stap 3: Voer de conversie uit

Voer de conversie uit met de eerder gedefinieerde opties. De lambda‑expressie maakt het uitvoerbestand on‑the‑fly aan, waardoor tijdelijke opslag wordt vermeden.

var convertOptions = new TextConvertOptions();

Waarom: Het gebruik van een lambda voor Save geeft je volledige controle over de output‑stream, wat vooral nuttig is bij integratie van de conversie in webservices of achtergrondprocessen.

Stap 4: Voer de conversie uit

Roep tenslotte de Convert‑methode aan, waarbij je het bron‑DGN‑pad, het doelformaat en het opties‑object doorgeeft.

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

Waarom: De methode behandelt alle low‑level parsing, tekst‑extractie en bestands‑schrijven in één enkele oproep, waardoor je niet meer met de complexe CAD‑internals hoeft te werken.

Veelvoorkomende problemen en oplossingen

  • File Not Found Error: Controleer of het DGN‑bestandspad absoluut is of correct relatief ten opzichte van het uitvoerbare bestand.
  • Permission Issues: Zorg ervoor dat de applicatie draait onder een account met schrijfrechten op de outputmap.
  • Conversion Errors: Verifieer dat de GroupDocs.Conversion NuGet‑pakketversie overeenkomt met de licentiebestandversie; niet‑overeenkomende versies kunnen runtime‑fouten veroorzaken.

Praktische toepassingen

Deze conversiemogelijkheid kan worden geïntegreerd in:

  1. Data Extraction: Tekstuele annotaties uit DGN‑tekeningen halen voor analytics of rapportage.
  2. Interoperability: De geëxtraheerde tekst invoeren in GIS‑systemen, BIM‑databases of legacy‑ERP‑modules die alleen platte‑tekst invoer accepteren.
  3. Automation Workflows: De conversiestap in CI/CD‑pijplijnen embedden om automatisch documentatie te genereren uit ontwerpbestanden.

Prestatieoverwegingen

Bij het verwerken van grote batches CAD‑bestanden, houd deze tips in gedachten:

  • Optimize Resource Usage: Monitor het geheugengebruik; GroupDocs verwerkt bestanden in streaming‑modus, waardoor de geheugenvoetafdruk laag blijft, zelfs bij tekeningen met honderden pagina’s.
  • Efficient Memory Management: Verwijder de Converter‑instantie na elke conversie om onbeheerste resources snel vrij te geven.
  • Batch Processing: Gebruik Parallel.ForEach om meerdere DGN‑bestanden gelijktijdig te converteren, maar beperk de graad van parallelisme om uitputting van CPU‑ of I/O‑bandbreedte te voorkomen.

Bronnen

Conclusie

Gefeliciteerd! Je hebt geleerd hoe je create output folder C# maakt, een DGN‑bestand laadt en het converteert naar TXT met GroupDocs.Conversion .NET. Door deze stappen in je applicaties te integreren, stroomlijn je data‑extractie, verbeter je interoperabiliteit en verhoog je de algehele productiviteit in je CAD‑gerichte workflows.

Verken extra formaten — zoals DGN → PDF of DGN → DOCX — door de TxtConvertOptions te vervangen door de juiste opties‑klasse. De GroupDocs‑suite biedt een uniforme API die meer dan 50 bestandstypen dekt, zodat je een enkele, onderhoudbare conversie‑engine kunt bouwen voor al je technische documenten.

Veelgestelde vragen

Q: Welke bestandsformaten ondersteunt GroupDocs.Conversion?
A: Over 50 formats, including PDF, DOCX, XLSX, DGN, DWG, DXF, and TXT.

Q: Is er een grootte‑limiet voor het converteren van DGN‑bestanden?
A: Geen harde limiet; de prestaties schalen met beschikbaar RAM en CPU. Bestanden tot 2 GB converteren betrouwbaar op standaard servers.

Q: Kan ik de tekencodering van de output‑TXT aanpassen?
A: Ja — stel de Encoding‑eigenschap in TxtConvertOptions in (bijv. UTF‑8, ASCII).

Q: Hoe moet ik conversiefouten in productie afhandelen?
A: Plaats de conversie‑aanroep in een try‑catch‑blok, log de details van ConversionException en probeer eventueel opnieuw met een fallback‑configuratie.

Q: Waar kan ik meer voorbeelden en API‑referenties vinden?
A: In de officiële documentatie en API‑referentie vind je uitgebreide code‑voorbeelden en configuratie‑handleidingen.

Laatst bijgewerkt: 2026-07-06
Getest met: GroupDocs.Conversion .NET 25.3.0
Auteur: GroupDocs

Gerelateerde tutorials