Como Converter DGN para PDF com GroupDocs.Conversion para .NET

Converter um desenho DGN para PDF é uma etapa comum quando você precisa compartilhar arquivos CAD com partes interessadas que não possuem software especializado. Neste tutorial você aprenderá como converter dgn para pdf de forma rápida e confiável usando GroupDocs.Conversion para .NET. Vamos percorrer a instalação, licenciamento e um exemplo completo de código, e então mostrar como otimizar o desempenho para desenhos de engenharia grandes.

Respostas Rápidas

Qual biblioteca lida com a conversão? GroupDocs.Conversion for .NET.
Chamada de método principal? converter.Convert(sourcePath, new PdfConvertOptions()).
Formatos CAD suportados? Mais de 30, incluindo DGN, DWG, DXF.
Tamanho máximo de arquivo? Até 2 GB podem ser processados sem carregar o arquivo inteiro na memória.
Requisito de licença? É necessária uma licença válida da GroupDocs para uso em produção.

O que é converter dgn para pdf?

convert dgn to pdf é o processo de transformar um arquivo MicroStation DGN em um Portable Document Format (PDF) que preserva gráficos vetoriais, camadas, espessuras de linha e anotações. Essa conversão permite renderização precisa, impressão e distribuição fácil em qualquer plataforma, permitindo que usuários sem software CAD visualizem o desenho exatamente como pretendido.

Por que usar GroupDocs.Conversion para .NET?

GroupDocs.Conversion suporta mais de 30 formatos de entrada e saída e pode lidar com arquivos de até 2 GB mantendo o uso de memória abaixo de 100 MB graças à sua arquitetura de streaming. A biblioteca funciona em .NET Framework 4.6+, .NET Core 3.1+, e .NET 6+, tornando-a adequada para cenários de desktop, web e nuvem.

Pré-requisitos

GroupDocs.Conversion for .NET (versão 25.3.0 ou posterior)
Um ambiente de desenvolvimento como Visual Studio 2022 ou Visual Studio Code
.NET 6 SDK instalado na sua máquina
Um arquivo de licença GroupDocs válido (trial ou comercial)

Bibliotecas Necessárias, Versões e Dependências

GroupDocs.Conversion for .NET – 25.3.0
Newtonsoft.Json – necessário para o gerenciamento interno de configuração (instalado automaticamente como dependência)

Requisitos de Configuração do Ambiente

Certifique-se de que o runtime .NET corresponde ao framework de destino do seu projeto. GroupDocs.Conversion funciona em Windows, Linux e macOS.

Como Converter DGN para PDF em C#?

A classe Converter é o componente central que carrega um documento e realiza conversões de formato. PdfConvertOptions especifica configurações para a saída PDF, como tamanho da página e incorporação de fontes. Carregue o arquivo DGN de origem, configure as opções de conversão e chame o método Convert – toda a operação pode ser executada em três linhas de código. Essa abordagem direta garante que camadas, espessuras de linha e anotações de texto sejam reproduzidas fielmente no PDF resultante.

// Define paths
string outputFolder = Path.Combine(@"YOUR_OUTPUT_DIRECTORY");
string documentPath = Path.Combine(@"YOUR_DOCUMENT_DIRECTORY\sample.dgn");

// Initialize the converter and perform conversion
var converter = new GroupDocs.Conversion.Converter(documentPath);
converter.Convert(outputFolder, new GroupDocs.Conversion.Options.PdfConvertOptions());

O trecho acima demonstra o fluxo de trabalho principal: instanciar a classe Converter, especificar o local de saída e passar um objeto PdfConvertOptions. A biblioteca detecta automaticamente o formato DGN e aplica o mecanismo de renderização apropriado.

Guia Passo a Passo

Etapa 1: Instalar o Pacote NuGet

Abra o Package Manager Console no Visual Studio e execute:

Install-Package GroupDocs.Conversion -Version 25.3.0

Ou use o .NET CLI se preferir a instalação via linha de comando:

dotnet add package GroupDocs.Conversion --version 25.3.0

Ambos os comandos adicionam o pacote GroupDocs.Conversion estável mais recente ao seu projeto.

Etapa 2: Adicionar sua Licença

Coloque o arquivo GroupDocs.Conversion.lic na raiz do seu projeto e registre-o na inicialização da aplicação:

GroupDocs.Conversion.License license = new GroupDocs.Conversion.License();
license.SetLicense("GroupDocs.Conversion.lic");

Dica profissional: Mantenha o arquivo de licença fora do controle de versão e carregue-o de um local seguro em produção.

Etapa 3: Executar a Conversão

Use o bloco de código mostrado anteriormente. Ajuste outputFolder e documentPath para apontar para seus diretórios reais. A classe PdfConvertOptions permite controlar o tamanho da página, orientação e se as fontes devem ser incorporadas.

Etapa 4: Verificar o Resultado

Após a conversão, abra o PDF gerado em qualquer visualizador para confirmar que todos os elementos do desenho aparecem corretamente. Para processamento em lote, envolva a chamada de conversão em um loop foreach sobre uma coleção de arquivos DGN.

Problemas Comuns e Soluções

Fontes ausentes – Certifique-se de que as fontes CAD necessárias estejam instaladas na máquina host ou incorpore-as via PdfConvertOptions.EmbedFonts = true.
Arquivos grandes causam timeouts – Aumente o timeout da requisição HTTP se estiver executando a conversão em uma API web, ou divida o desenho em folhas menores antes da conversão.
Licença não encontrada – Verifique o caminho para GroupDocs.Conversion.lic e confirme que o arquivo tem permissões de leitura para o processo em execução.

Perguntas Frequentes

Q: Posso converter arquivos DGN protegidos por senha?
A: Sim. Forneça a senha através da sobrecarga do construtor Converter que aceita um objeto LoadOptions. LoadOptions permite fornecer parâmetros adicionais, como senhas, ao carregar um documento.

Q: A biblioteca funciona em contêineres Linux?
A: Absolutamente. GroupDocs.Conversion para .NET é totalmente multiplataforma e roda em contêineres Docker baseados em Alpine ou Ubuntu.

Q: Quais versões do .NET são suportadas?
A: .NET Framework 4.6+, .NET Core 3.1+, .NET 5 e .NET 6 são todas oficialmente suportadas.

Q: Como lidar com conversão em lote de milhares de desenhos?
A: Use processamento assíncrono com Task.WhenAll (Task.WhenAll aguarda a conclusão de múltiplas operações assíncronas) e limite a concorrência para evitar esgotar CPU ou memória.

Q: Existe uma maneira de converter apenas um layout ou folha específico?
A: Sim. Defina PdfConvertOptions.Layouts para uma coleção contendo os identificadores de layout desejados.

Conclusão

Agora você tem um guia completo e pronto para produção para converter dgn para pdf usando GroupDocs.Conversion para .NET. Seguindo os passos acima, você pode integrar a conversão de CAD para PDF em ferramentas desktop, serviços web ou pipelines automatizados com esforço mínimo. Explore opções adicionais como marca d’água, criptografia e dimensionamento de página personalizado para adequar a saída aos padrões da sua organização.

Última Atualização: 2026-06-15
Testado com: GroupDocs.Conversion 25.3.0 for .NET
Autor: GroupDocs

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

// Initialize converter object
groupdocsConversion = new Converter("path/to/your/file.dgn");

// Convert to PDF settings
PdfConvertOptions options = new PdfConvertOptions();

{< /blocks/products/pf/tutorial-page-section >} {< /blocks/products/pf/main-container >} {< /blocks/products/pf/main-wrap-class >} {< blocks/products/products-backtop-button >}