Como Converter Arquivos DGN para TXT Usando GroupDocs.Conversion .NET

Introdução

Você está procurando uma maneira eficiente de create output folder C# e transformar arquivos DGN complexos em um formato TXT mais manejável? Muitos arquitetos, engenheiros e profissionais da construção precisam extrair dados em texto simples de desenhos CAD para relatórios, pipelines de análise de dados ou integração com sistemas legados. Este tutorial mostra como usar GroupDocs.Conversion .NET para carregar um arquivo DGN, configurar um diretório de saída adequado e gerar um arquivo TXT limpo — tudo com código pronto para produção.

O que você aprenderá

  • Como configurar o GroupDocs.Conversion para .NET
  • Como create output folder C# e especificar o destino dos arquivos convertidos
  • Como carregar um arquivo DGN e convertê‑lo para TXT
  • Opções de configuração chave que permitem ajustar finamente o processo de conversão

Respostas Rápidas

  • Qual biblioteca realiza a conversão DGN‑para‑TXT? GroupDocs.Conversion .NET
  • Preciso de licença para uso em produção? Sim, é necessária uma licença completa ou temporária.
  • Posso executar isso no .NET 6? Absolutamente – a biblioteca suporta .NET 5/6, .NET Core 3.1 e .NET Framework 4.5+.
  • Como criar a pasta de saída em C#? Use Directory.CreateDirectory(path) antes da conversão.
  • Qual a velocidade típica de conversão? Converter um DGN de 200 páginas para TXT geralmente termina em menos de 2 segundos em um servidor padrão.

O que é “create output folder C#”?

Create output folder C# refere‑se a garantir programaticamente que um diretório exista no sistema de arquivos antes de gravar arquivos nele, tipicamente usando System.IO.Directory.CreateDirectory. Isso impede erros de “caminho não encontrado” durante operações de escrita.

Por que usar GroupDocs.Conversion para CAD para TXT?

GroupDocs.Conversion suporta mais de 50 formatos de entrada e saída, incluindo DGN, DWG e DXF, e pode processar arquivos de até 2 GB sem carregar todo o documento na memória. Seu motor nativo de extração de texto preserva nomes de camadas, anotações e dados de atributos, entregando um arquivo TXT que reflete o conteúdo textual do desenho original com 99 % de fidelidade.

Pré‑requisitos

  • Biblioteca GroupDocs.Conversion .NET (versão 25.3.0 ou posterior)
  • Visual Studio 2022 (ou qualquer IDE que suporte C# 8.0+)
  • .NET 6 SDK (ou .NET Core 3.1 / .NET Framework 4.5+)
  • Uma licença válida do GroupDocs (versão de avaliação gratuita ou licença temporária funciona para testes)

Configurando GroupDocs.Conversion para .NET

Instale a biblioteca GroupDocs.Conversion usando o gerenciador de pacotes de sua escolha.

Console do NuGet Package Manager:

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI:

dotnet add package GroupDocs.Conversion --version 25.3.0

Dica profissional: Após a instalação, adicione o arquivo de licença ao seu projeto e carregue‑o na inicialização da aplicação para evitar erros de licença em tempo de execução.

Inicialização Básica

A classe Converter é o componente central do GroupDocs.Conversion que carrega arquivos de origem e realiza transformações de formato.

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

Guia de Implementação

Como criar uma pasta de saída em C#?

Directory.CreateDirectory cria todos os diretórios e subdiretórios no caminho especificado caso ainda não existam.

Use Directory.CreateDirectory para garantir que o caminho de destino exista antes de invocar a API de conversão. Essa única linha cria a pasta se ela estiver ausente e tem sucesso silencioso se a pasta já existir, eliminando exceções de “diretório não encontrado” durante gravações de arquivos. Ela também devolve o caminho completo, que pode ser reutilizado para logs ou processamento adicional.

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

Carregar e Converter Arquivo DGN para TXT

Visão geral

Este recurso permite carregar um arquivo DGN e convertê‑lo em uma representação de texto simples (TXT), útil para extrair notas de design, metadados ou comentários incorporados em desenhos arquitetônicos.

Etapa 1: Definir o Caminho do Diretório de Saída

Especifique onde seus arquivos convertidos serão salvos. O exemplo abaixo cria uma pasta chamada ConvertedFiles no diretório raiz da aplicação.

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

Por quê: Definir um caminho de saída dedicado mantém seu projeto organizado e facilita a localização dos arquivos TXT gerados para processamento posterior.

Etapa 2: Configurar Opções de Conversão

A classe TxtConvertOptions contém as configurações necessárias para a conversão, permitindo personalizar quebras de linha, codificação e se camadas ocultas devem ser incluídas.

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

O que faz: Este objeto informa ao conversor exatamente como renderizar a representação textual, garantindo resultados consistentes entre diferentes fontes DGN.

Etapa 3: Executar a Conversão

Execute a conversão com as opções previamente definidas. A expressão lambda cria o arquivo de saída em tempo real, evitando armazenamento temporário.

var convertOptions = new TextConvertOptions();

Por quê: Usar uma lambda para Save dá controle total sobre o fluxo de saída, o que é especialmente útil ao integrar a conversão em serviços web ou workers em segundo plano.

Etapa 4: Iniciar a Conversão

Por fim, invoque o método Convert, passando o caminho do DGN de origem, o formato de destino e o objeto de opções.

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

Por quê: O método lida com todo o parsing de baixo nível, extração de texto e gravação de arquivo em uma única chamada, liberando você de lidar com a complexidade interna do CAD.

Problemas Comuns e Soluções

  • Erro de Arquivo Não Encontrado: Verifique se o caminho do arquivo DGN é absoluto ou relativo corretamente ao executável.
  • Problemas de Permissão: Garanta que a aplicação seja executada com uma conta que tenha acesso de gravação à pasta de saída.
  • Erros de Conversão: Confirme que a versão do pacote NuGet GroupDocs.Conversion corresponde à versão do arquivo de licença; versões incompatíveis podem causar falhas em tempo de execução.

Aplicações Práticas

Esta capacidade de conversão pode ser integrada em:

  1. Extração de Dados: Capturar anotações textuais de desenhos DGN para análises ou relatórios.
  2. Interoperabilidade: Alimentar texto extraído em sistemas GIS, bancos de dados BIM ou módulos ERP legados que aceitam apenas entradas em texto simples.
  3. Fluxos de Trabalho Automatizados: Incorporar a etapa de conversão em pipelines CI/CD para gerar documentação automaticamente a partir de arquivos de design.

Considerações de Desempenho

Ao processar grandes lotes de arquivos CAD, tenha em mente estas dicas:

  • Otimizar Uso de Recursos: Monitore o consumo de memória; o GroupDocs processa arquivos em modo streaming, mantendo a pegada de memória baixa mesmo para desenhos com centenas de páginas.
  • Gerenciamento Eficiente de Memória: Libere a instância Converter após cada conversão para liberar recursos não gerenciados prontamente.
  • Processamento em Lote: Use Parallel.ForEach para converter múltiplos arquivos DGN simultaneamente, mas limite o grau de paralelismo para não esgotar CPU ou largura de banda de I/O.

Recursos

Conclusão

Parabéns! Você aprendeu como create output folder C#, carregar um arquivo DGN e convertê‑lo para TXT usando GroupDocs.Conversion .NET. Ao integrar essas etapas em suas aplicações, você simplifica a extração de dados, melhora a interoperabilidade e aumenta a produtividade geral em fluxos de trabalho centrados em CAD.

Explore formatos adicionais — como DGN → PDF ou DGN → DOCX — trocando o TxtConvertOptions pela classe de opções apropriada. A suíte GroupDocs oferece uma API unificada que cobre mais de 50 tipos de arquivos, permitindo que você construa um motor de conversão único e fácil de manter para todos os seus documentos de engenharia.

Perguntas Frequentes

Q: Quais formatos de arquivo o GroupDocs.Conversion suporta?
A: Mais de 50 formatos, incluindo PDF, DOCX, XLSX, DGN, DWG, DXF e TXT.

Q: Existe um limite de tamanho para converter arquivos DGN?
A: Não há limite rígido; o desempenho escala com a RAM e CPU disponíveis. Arquivos de até 2 GB convertem de forma confiável em servidores padrão.

Q: Posso personalizar a codificação de texto do TXT de saída?
A: Sim — defina a propriedade Encoding em TxtConvertOptions (ex.: UTF‑8, ASCII).

Q: Como devo tratar erros de conversão em produção?
A: Envolva a chamada de conversão em um bloco try‑catch, registre detalhes de ConversionException e, opcionalmente, tente novamente com uma configuração alternativa.

Q: Onde encontro mais exemplos e referências de API?
A: A documentação oficial e a referência de API fornecem amostras de código extensas e guias de configuração.

Última atualização: 2026-07-06
Testado com: GroupDocs.Conversion .NET 25.3.0
Autor: GroupDocs

Tutoriais Relacionados