Конвертировать DGN в Excel (XLSX) на C# с использованием GroupDocs.Conversion для .NET

Введение

Если вам нужно convert dgn to excel, GroupDocs.Conversion for .NET предлагает быстрое, надёжное решение, которое работает на любой платформе .NET. В этом руководстве мы пройдём процесс установки библиотеки, настройки конвертации и выполнения кода, который преобразует файл AutoCAD Design (DGN) в чистую таблицу XLSX. К концу вы поймёте, почему этот подход предпочтителен в корпоративных конвейерах и как интегрировать его в свои проекты.

Быстрые ответы

  • Какая библиотека конвертирует DGN в Excel? GroupDocs.Conversion for .NET.
  • Сколько времени занимает базовая реализация? Около 10‑15 минут на написание и запуск.
  • Какие версии .NET поддерживаются? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6+.
  • Нужна ли лицензия для продакшна? Да – платная лицензия снимает ограничения пробной версии.
  • Можно ли установить через NuGet? Конечно – используйте пакет GroupDocs.Conversion.

Что такое convert dgn to excel?

Convert dgn to excel — процесс извлечения табличных и атрибутных данных из чертежа DGN (MicroStation) и сохранения их в виде книги Excel (XLSX). Это позволяет выполнять последующий анализ, составлять отчёты и интегрировать данные в бизнес‑системы без ручного ввода.

Почему стоит использовать GroupDocs.Conversion для .NET при конвертации DGN в Excel?

GroupDocs.Conversion для .NET поддерживает более 50 форматов ввода и вывода и может обрабатывать многосотстраничные файлы DGN без загрузки всего документа в память, снижая использование ОЗУ до 70 %. Библиотека также сохраняет таблицы, слои и атрибутные данные, обеспечивая точность конвертации более > 98 % в тестах производительности.

Предварительные требования

  • GroupDocs.Conversion for .NET версии 25.3.0 (или новее).
  • Среда разработки с .NET Core 3.1, .NET 5/6 или .NET Framework 4.6+.
  • Базовые знания C# и доступ к NuGet Package Manager.

Требуемые библиотеки и версии

  • GroupDocs.Conversion for .NET версии 25.3.0.

Требования к настройке среды

  • Среда разработки с .NET (желательно .NET Core или .NET Framework).

Требования к знаниям

  • Базовое понимание программирования на C#.
  • Знакомство с использованием NuGet Package Manager.

Имея все предварительные требования, перейдём к установке GroupDocs.Conversion для .NET.

Как установить GroupDocs Conversion через NuGet?

Установка проста: откройте Visual Studio, запустите консоль Package Manager Console и выполните команду Install‑Package. Система NuGet разрешает все зависимости, добавляет сборку GroupDocs.Conversion в ваш проект и обновляет файл проекта, чтобы вы могли сразу приступить к кодированию.

Install-Package GroupDocs.Conversion

Или, используя .NET CLI, выполните:

dotnet add package GroupDocs.Conversion

Обе команды получают последнюю стабильную версию из репозитория NuGet, гарантируя наличие всех необходимых зависимостей.

Установка

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Conversion --version 25.3.0

Шаги получения лицензии

GroupDocs предлагает различные варианты лицензирования:

  1. Free Trial – Тестирование базовых функций.
  2. Temporary License – Увеличение времени оценки для крупных проектов.
  3. Purchase – Полное использование в продакшене. Смотрите официальный магазин по адресу GroupDocs.

Базовая инициализация и настройка

GroupDocs.Conversion — основной класс, управляющий преобразованием файлов. После добавления пакета вы создаёте объект Converter с путём к исходному файлу и необязательной конфигурацией.

Инициализация конвертера Converter — основной класс, используемый для загрузки документа и выполнения конвертаций.

using System;
using GroupDocs.Conversion;

// Initialize the converter with the source DGN file path
var documentPath = "YOUR_DOCUMENT_DIRECTORY\sample.dgn";
using (var converter = new Converter(documentPath))
{
    // Conversion logic will go here
}

С настройкой завершённой, давайте реализуем процесс конвертации.

Как конвертировать DGN в Excel на C#?

Рабочий процесс конвертации состоит из загрузки файла DGN, настройки параметров таблицы и вызова метода Convert. Используя класс Converter вместе с SpreadsheetConvertOptions, вы можете управлять именами листов, включать метаданные и ограничивать страницы, обеспечивая эффективный и точный вывод в Excel для чертежей любого размера.

Загрузка исходного файла DGN

Сначала определите абсолютные или относительные пути к входному DGN и выходному XLSX.

Шаг 1: Определение путей к файлам

string documentPath = System.IO.Path.Combine("YOUR_DOCUMENT_DIRECTORY", "sample.dgn");
string outputFolder = System.IO.Path.Combine("YOUR_OUTPUT_DIRECTORY", "output");
string outputFile = System.IO.Path.Combine(outputFolder, "dgn-converted-to.xlsx");

// Ensure the output directory exists
if (!System.IO.Directory.Exists(outputFolder))
{
    System.IO.Directory.CreateDirectory(outputFolder);
}

Шаг 2: Загрузка файла DGN

using (var converter = new Converter(documentPath))
{
    // Conversion process will be defined here
}

Настройка параметров конвертации

ConversionException выбрасывается, когда процесс конвертации сталкивается с ошибкой.
SpreadsheetConvertOptions определяет настройки вывода в Excel, такие как именование листов, включение метаданных и диапазон страниц.

// Specify that we're converting to an Excel spreadsheet format
var options = new SpreadsheetConvertOptions();

Выполнение конвертации

Наконец, выполните конвертацию и запишите результат на диск.

Шаг 4: Выполнение и сохранение конвертации

converter.Convert(outputFile, options);

Советы по устранению неполадок

  • Permissions – Убедитесь, что процесс имеет права чтения/записи к папкам.
  • Error Handling – Оберните вызов конвертации в блок try‑catch, чтобы перехватить ConversionException и записать детали.

Распространённые проблемы и решения

ПроблемаРешение
Ошибка «File not found»Используйте Path.GetFullPath для разрешения относительных путей и убедитесь, что файл существует.
Пики использования памяти при больших DGNОбрабатывайте файл частями, задавая ConverterOptions.PageRange для ограничения количества страниц за одну конвертацию.
Отсутствие данных в ExcelВключите SpreadsheetConvertOptions.IncludeMetadata = true, чтобы сохранить атрибутные таблицы.

Практические применения

Конвертация файлов DGN в Excel полезна для:

  1. Project Management – Экспорт спецификаций и данных расписания в таблицы для отслеживания.
  2. Data Analysis – Использование сводных таблиц и графиков Excel для данных, полученных из CAD.
  3. ERP Integration – Автоматизация передачи спецификаций дизайна в системы планирования ресурсов предприятия (ERP).

Соображения по производительности

Чтобы конвертация была быстрой и экономичной по памяти:

  • Закрывайте неиспользуемые приложения во время пакетных запусков.
  • Своевременно освобождайте объекты с помощью операторов using.
  • Повторно используйте один экземпляр Converter для нескольких файлов, когда это возможно.

Заключение

Теперь у вас есть полностью готовый к продакшену шаблон для конвертации DGN в Excel (XLSX) с помощью GroupDocs.Conversion для .NET. Этот подход уменьшает ручной ввод данных, ускоряет составление отчётов и бесшовно интегрируется с бэкенд‑сервисами на базе .NET. Исследуйте дополнительные форматы — PDF, DOCX, PPTX — и расширяйте свой конвейер автоматизации.

Часто задаваемые вопросы

Q: Могу ли я конвертировать другие форматы CAD, кроме DGN?
A: Да, GroupDocs.Conversion также поддерживает файлы DWG, DXF и DWF, позволяя получать тот же вывод в XLSX.

Q: Есть ли ограничение размера файла для пробной версии?
A: Пробная версия ограничивает конвертацию файлов размером менее 5 МБ; временная или платная лицензия снимает это ограничение.

Q: Как обрабатывать DGN‑файлы, защищённые паролем?
A: Передайте пароль в конструктор Converter через ConverterSettings.Password.

Q: Работает ли библиотека в контейнерах Linux?
A: Да – GroupDocs.Conversion кроссплатформен и работает в Docker‑образах на основе .NET Core.

Q: Где можно найти подробную документацию API?
A: Посетите официальную документацию по адресу Documentation.

Последнее обновление: 2026-06-30
Тестировано с: GroupDocs.Conversion 25.3.0 for .NET
Автор: GroupDocs

Ресурсы

Счастливого кодинга и изучайте весь потенциал GroupDocs.Conversion для .NET!

Связанные руководства