Efficiënte conversie van DGN-bestanden naar HTML met groupdocs conversion .net

Het converteren van DGN‑bestanden naar een web‑vriendelijk HTML‑formaat kan een hoofdpijn zijn, vooral wanneer je lagen, annotaties en complexe geometrie moet behouden. groupdocs conversion .net verwijdert die pijn door het zware werk af te handelen met een paar beknopte C#‑aanroepen. In deze tutorial zie je precies hoe je een DGN‑tekening laadt, HTML‑uitvoeropties aanpast en het resultaat opslaat — allemaal met prestaties in gedachten.

Snelle Antwoorden

  • Welke bibliotheek verwerkt DGN‑naar‑HTML conversie? groupdocs conversion .net
  • Welke taal wordt gebruikt? C# (.NET Core of .NET Framework)
  • Heb ik een licentie nodig voor testen? Een gratis proefversie werkt voor evaluatie; een licentie is vereist voor productie.
  • Kunnen grote tekeningen efficiënt worden verwerkt? Ja – de API streamt gegevens en ondersteunt bestanden > 2 GB.
  • Waar kan ik de volledige API‑referentie vinden? In de officiële GroupDocs‑documentatie die hieronder is gelinkt.

Wat is groupdocs conversion .net?

groupdocs conversion .net is een .NET‑bibliotheek die ontwikkelaars in staat stelt om meer dan 100+ document‑, afbeelding‑ en CAD‑formaten — inclusief DGN — te converteren naar PDF, HTML en vele andere uitvoertypen zonder software van derden. Het biedt een eendrachtige API voor het verwerken van complexe tekeningen, het behouden van lagen, lijntypen en tekstopmaak, terwijl het snelle, geheugen‑efficiënte conversies levert die geschikt zijn voor zowel desktop‑ als serveromgevingen.

Waarom groupdocs conversion .net gebruiken voor DGN naar HTML?

Snelheid: Benchmarks tonen aan dat een DGN‑bestand van 500 pagina’s in minder dan 12 seconden wordt geconverteerd op een standaard 8‑core server. Geheugenefficiëntie: De bibliotheek streamt de inhoud, zodat het geheugengebruik onder 150 MB blijft, zelfs bij tekeningen van meerdere gigabytes. Nauwkeurigheid: Ondersteunt MicroStation V8‑ en V8i‑functies, waarbij lagen, lijntypen en tekstopmaak in de gegenereerde HTML behouden blijven.

Voorvereisten

  • GroupDocs.Conversion for .NET – installeren via NuGet of .NET CLI (zie hieronder).
  • Visual Studio 2022 of een andere C#‑compatibele IDE.
  • Basiskennis van C# en vertrouwdheid met bestands‑I/O.

GroupDocs.Conversion voor .NET instellen

Installeer het NuGet‑pakket

NuGet Package Manager Console

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Conversion --version 25.3.0

Licentie‑acquisitie

  • Gratis proefversie: Download van de GroupDocs website.
  • Tijdelijke licentie: Vraag een tijdelijke licentie aan om alle functies te ontgrendelen.
  • Aankoop: Overweeg een licentie te kopen op hun purchase page.

Basisinitialisatie en -configuratie

Importeer eerst de benodigde namespaces:

using GroupDocs.Conversion;

Converter is de hoofdklasse die een bron‑document laadt en het conversieproces coördineert.
Maak vervolgens een Converter‑instantie die de conversiepijplijn beheert:

string documentPath = "YOUR_DOCUMENT_DIRECTORY\\sample.dgn";
using (var converter = new Converter(documentPath))
{
    // Your conversion logic goes here.
}

Hoe DGN naar HTML converteren met groupdocs conversion .net?

Laad je DGN‑bestand met new Converter("source.dgn") en roep Convert aan terwijl je een WebConvertOptions‑object doorgeeft – dat is alles wat je nodig hebt om een volledig functionele HTML‑representatie te genereren in slechts twee regels code. De API behandelt automatisch paginering, vector‑graphics en tekstreeks, waardoor je een direct publiceerbare webpagina krijgt.

Stap 1: Laad het DGN‑bestand

Geef het pad naar de bron‑tekening op en instantieer de converter:

   string documentPath = "YOUR_DOCUMENT_DIRECTORY\\sample.dgn";

Stap 2: Configureer HTML‑conversie‑opties

WebConvertOptions definieert instellingen voor HTML‑output, zoals het insluiten van bronnen en het omgaan met lagen.

   using (var converter = new Converter(documentPath))
   {
       // The file is now loaded and ready for conversion.
   }

Stap 3: Stel de uitvoermap in

Kies een map waarin de HTML‑bestanden en eventuele ondersteunende assets worden weggeschreven:

   var options = new WebConvertOptions();

Stap 4: Voer de conversie uit

Convert voert de conversie uit met de opgegeven opties en schrijft het resultaat naar de doel‑locatie.

   string outputFolder = "YOUR_OUTPUT_DIRECTORY";
   string outputFile = Path.Combine(outputFolder, "dgn-converted-to.html");

Praktische Toepassingen

  1. Delen van architecturale ontwerpen – Converteer DGN‑tekeningen naar HTML zodat klanten plannen direct in elke browser kunnen bekijken.
  2. Cross‑platform bekijken – Sta ingenieurs toe CAD‑gegevens te bekijken op tablets, telefoons of low‑power apparaten zonder MicroStation te installeren.
  3. Integratie in webportaal – Integreer de conversiestap in een document‑managementsysteem om het publiceren van nieuwe ontwerpen te automatiseren.

Prestatie‑overwegingen

  • Streaming: De bibliotheek streamt zowel invoer als uitvoer, waardoor het RAM‑gebruik laag blijft, zelfs bij bestanden van meerdere gigabytes.
  • Asynchrone API: Gebruik ConvertAsync voor niet‑blokkende UI‑ of web‑service‑scenario’s. ConvertAsync voert de conversie asynchroon uit en retourneert een Task.
  • Batchverwerking: Loop door een map met DGN‑bestanden en converteer ze parallel om de CPU‑benutting te maximaliseren.

Veelvoorkomende problemen en oplossingen

  • Ontbrekende lettertypen: Zorg ervoor dat de vereiste MicroStation‑lettertypen op de server zijn geïnstalleerd; anders valt de API terug op een standaardlettertype.
  • Grote bestanden (>2 GB): Verhoog de MemoryLimit‑eigenschap in ConversionConfig om een OutOfMemoryException te voorkomen. ConversionConfig stelt je in staat runtime‑instellingen zoals geheugengrenzen aan te passen.
  • Onjuiste lay-out: Controleer of WebConvertOptions EnableLayers = true heeft om de zichtbaarheid van lagen te behouden.

Veelgestelde vragen

Q: Wat is een DGN‑bestand?
A: Een DGN‑bestand is een CAD‑tekenformaat dat voornamelijk wordt gebruikt door MicroStation voor technische en architecturale ontwerpen.

Q: Kan ik andere CAD‑formaten converteren met groupdocs conversion .net?
A: Ja, de bibliotheek ondersteunt meer dan 100 formaten, inclusief DWG, DXF en IFC, naast DGN.

Q: Hoe verwerk ik grote tekeningen efficiënt?
A: Gebruik de streaming‑API, schakel asynchrone conversie in en pas de geheugengrenzen aan zoals beschreven in de prestatiesectie.

Q: Is de HTML‑output aanpasbaar?
A: Absoluut – WebConvertOptions stelt je in staat CSS in te sluiten, aparte asset‑mappen te kiezen en paginanummering te regelen.

Q: Waar kan ik hulp krijgen als ik een fout tegenkom?
A: Bezoek het Help Forum voor community‑ondersteuning en officiële probleemoplossingsgidsen.

Bronnen

Laatst bijgewerkt: 2026-06-20
Getest met: GroupDocs.Conversion 23.12 for .NET
Auteur: GroupDocs

   using (var converter = new Converter("YOUR_DOCUMENT_DIRECTORY\\sample.dgn"))
   {
       var options = new WebConvertOptions();
       converter.Convert(outputFile, options);
   }

Gerelateerde tutorials