Comment convertir des fichiers DGN en TXT avec GroupDocs.Conversion .NET

Introduction

Cherchez‑vous une méthode efficace pour create output folder C# et transformer des fichiers DGN complexes en un format TXT plus maniable ? De nombreux architectes, ingénieurs et professionnels de la construction ont besoin d’extraire des données texte brut à partir de dessins CAD pour des rapports, des pipelines d’analyse de données ou l’intégration avec des systèmes hérités. Ce tutoriel vous guide à travers l’utilisation de GroupDocs.Conversion .NET pour charger un fichier DGN, configurer un répertoire de sortie approprié et générer un fichier TXT propre — le tout avec du code clair, prêt pour la production.

Ce que vous allez apprendre

  • Comment configurer GroupDocs.Conversion pour .NET
  • Comment create output folder C# et spécifier la destination des fichiers convertis
  • Comment charger un fichier DGN et le convertir en TXT
  • Options de configuration clés qui vous permettent d’ajuster finement le processus de conversion

Réponses rapides

  • Quelle bibliothèque gère la conversion DGN‑vers‑TXT ? GroupDocs.Conversion .NET
  • Ai‑je besoin d’une licence pour une utilisation en production ? Oui, une licence complète ou temporaire est requise.
  • Puis‑je exécuter cela sur .NET 6 ? Absolument – la bibliothèque prend en charge .NET 5/6, .NET Core 3.1 et .NET Framework 4.5+.
  • Comment créer le dossier de sortie en C# ? Utilisez Directory.CreateDirectory(path) avant la conversion.
  • Quelle est la vitesse de conversion typique ? Convertir un DGN de 200 pages en TXT se termine généralement en moins de 2 secondes sur un serveur standard.

Qu’est‑ce que “create output folder C#” ?

Create output folder C# désigne le fait d’assurer programmatique qu’un répertoire existe sur le système de fichiers avant d’y écrire des fichiers, généralement en utilisant System.IO.Directory.CreateDirectory. Cela empêche les erreurs « path not found » lors des opérations d’écriture de fichiers.

Pourquoi utiliser GroupDocs.Conversion pour CAD vers TXT ?

GroupDocs.Conversion prend en charge plus de 50 formats d’entrée et de sortie, dont DGN, DWG et DXF, et peut traiter des fichiers jusqu’à 2 GB sans charger le document complet en mémoire. Son moteur natif d’extraction de texte préserve les noms de calques, les annotations et les données d’attributs, délivrant un fichier TXT qui reflète le contenu textuel du dessin original avec 99 % de fidélité.

Prérequis

  • GroupDocs.Conversion .NET library (version 25.3.0 ou ultérieure)
  • Visual Studio 2022 (ou tout IDE qui prend en charge C# 8.0+)
  • .NET 6 SDK (ou .NET Core 3.1 / .NET Framework 4.5+)
  • Une licence GroupDocs valide (essai gratuit ou licence temporaire fonctionne pour les tests)

Configuration de GroupDocs.Conversion pour .NET

Installez la bibliothèque GroupDocs.Conversion en utilisant le gestionnaire de paquets de votre choix.

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: Après l’installation, ajoutez le fichier de licence à votre projet et chargez‑le au démarrage de l’application pour éviter les erreurs de licence à l’exécution.

Initialisation de base

La classe Converter est le composant central de GroupDocs.Conversion qui charge les fichiers source et effectue les transformations de format.

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

Guide de mise en œuvre

Comment créer un dossier de sortie en C# ?

Directory.CreateDirectory crée tous les répertoires et sous‑répertoires dans le chemin spécifié s’ils n’existent pas déjà.

Utilisez Directory.CreateDirectory pour vous assurer que le chemin de destination existe avant d’appeler l’API de conversion. Cette ligne unique crée le dossier s’il manque et réussit silencieusement s’il existe déjà, éliminant les exceptions « directory not found » lors des écritures de fichiers. Elle renvoie également le chemin complet, que vous pouvez réutiliser pour la journalisation ou un traitement ultérieur.

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

Charger et convertir un fichier DGN en TXT

Vue d’ensemble

Cette fonctionnalité vous permet de charger un fichier DGN et de le convertir en une représentation texte brut (TXT), pratique pour extraire les notes de conception, les métadonnées ou les commentaires intégrés des dessins architecturaux.

Étape 1 : définir le chemin du répertoire de sortie

Spécifiez où vos converted files seront enregistrés. L’exemple ci‑dessous crée un dossier nommé ConvertedFiles dans le répertoire racine de l’application.

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

Pourquoi : Définir un chemin de sortie dédié garde votre projet organisé et facilite la localisation des generated TXT files pour les traitements en aval.

Étape 2 : configurer les options de conversion

La classe TxtConvertOptions contient les paramètres requis pour la conversion, vous permettant de personnaliser les fins de ligne, l’encodage et d’inclure ou non les calques cachés.

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

Ce que cela fait : Cet objet indique au convertisseur exactement comment rendre la représentation textuelle, garantissant des résultats cohérents quel que soit le fichier DGN source.

Étape 3 : effectuer la conversion

Exécutez la conversion avec les options précédemment définies. L’expression lambda crée le fichier de sortie à la volée, évitant le stockage temporaire.

var convertOptions = new TextConvertOptions();

Pourquoi : Utiliser une lambda pour Save vous donne un contrôle total sur le flux de sortie, ce qui est particulièrement utile lors de l’intégration de la conversion dans des services web ou des workers en arrière‑plan.

Étape 4 : exécuter la conversion

Enfin, invoquez la méthode Convert, en passant le chemin du DGN source, le format cible et l’objet d’options.

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

Pourquoi : La méthode gère tout le parsing bas‑niveau, l’extraction de texte et l’écriture du fichier en un seul appel, vous libérant de la gestion des internals complexes du CAD.

Problèmes courants et solutions

  • Erreur fichier introuvable : Vérifiez que le chemin du fichier DGN est absolu ou correctement relatif à l’exécutable.
  • Problèmes d’autorisations : Assurez‑vous que l’application s’exécute avec un compte disposant d’un accès en écriture au dossier de sortie.
  • Erreurs de conversion : Confirmez que la version du package NuGet GroupDocs.Conversion correspond à la version du fichier de licence ; des versions incompatibles peuvent provoquer des échecs à l’exécution.

Applications pratiques

Cette capacité de conversion peut être intégrée à :

  1. Extraction de données : Extraire les annotations textuelles des dessins DGN pour l’analyse ou les rapports.
  2. Interopérabilité : Alimenter le texte extrait dans les systèmes GIS, bases de données BIM ou modules ERP hérités qui n’acceptent que des entrées texte brut.
  3. Flux de travail automatisés : Intégrer l’étape de conversion dans les pipelines CI/CD pour générer automatiquement de la documentation à partir des fichiers de conception.

Considérations de performance

Lors du traitement de gros lots de fichiers CAD, gardez ces conseils à l’esprit :

  • Optimiser l’utilisation des ressources : Surveillez la consommation de mémoire ; GroupDocs traite les fichiers en mode streaming, ce qui maintient une faible empreinte mémoire même pour des dessins de plusieurs centaines de pages.
  • Gestion efficace de la mémoire : Libérez l’instance Converter après chaque conversion pour libérer rapidement les ressources non gérées.
  • Traitement par lots : Utilisez Parallel.ForEach pour convertir plusieurs fichiers DGN en parallèle, mais limitez le degré de parallélisme afin de ne pas épuiser le CPU ou la bande passante I/O.

Ressources

Conclusion

Félicitations ! Vous avez appris comment create output folder C#, charger un fichier DGN et le convertir en TXT avec GroupDocs.Conversion .NET. En intégrant ces étapes dans vos applications, vous rationaliserez l’extraction de données, améliorerez l’interopérabilité et augmenterez la productivité globale de vos flux de travail centrés sur le CAD.

Explorez des formats supplémentaires—tels que DGN → PDF ou DGN → DOCX—en remplaçant le TxtConvertOptions par la classe d’options appropriée. La suite GroupDocs offre une API unifiée qui couvre plus de 50 types de fichiers, vous permettant de créer un moteur de conversion unique et maintenable pour tous vos documents d’ingénierie.

Questions fréquentes

Q : Quels formats de fichiers GroupDocs.Conversion prend‑il en charge ?
R : Plus de 50 formats, dont PDF, DOCX, XLSX, DGN, DWG, DXF et TXT.

Q : Existe‑t‑il une limite de taille pour la conversion des fichiers DGN ?
R : Aucun plafond strict ; les performances évoluent avec la RAM et le CPU disponibles. Les fichiers jusqu’à 2 GB se convertissent de façon fiable sur des serveurs standards.

Q : Puis‑je personnaliser l’encodage texte du fichier TXT de sortie ?
R : Oui—définissez la propriété Encoding dans TxtConvertOptions (par ex., UTF‑8, ASCII).

Q : Comment gérer les erreurs de conversion en production ?
R : Enveloppez l’appel de conversion dans un bloc try‑catch, consignez les détails de ConversionException et, si besoin, réessayez avec une configuration de secours.

Q : Où puis‑je trouver plus d’exemples et de références API ?
R : La documentation officielle et la référence API offrent de nombreux exemples de code et guides de configuration.

Last Updated: 2026-07-06
Tested With: GroupDocs.Conversion .NET 25.3.0
Author: GroupDocs

Tutoriels associés