Как конвертировать файлы DGN в TXT с помощью GroupDocs.Conversion .NET

Введение

Ищете эффективный способ create output folder C# и преобразовать сложные файлы DGN в более удобный формат TXT? Многие архитекторы, инженеры и специалисты в сфере строительства нуждаются в извлечении обычного текстового данных из чертежей CAD для отчетности, конвейеров анализа данных или интеграции с наследуемыми системами. Этот учебник покажет, как использовать GroupDocs.Conversion .NET для загрузки файла DGN, настройки правильного каталога вывода и создания чистого файла TXT — всё с понятным, готовым к продакшену кодом.

Что вы узнаете

• Как настроить GroupDocs.Conversion для .NET
• Как create output folder C# и указать место назначения для конвертированных файлов
• Как загрузить файл DGN и конвертировать его в TXT
• Ключевые параметры конфигурации, позволяющие точно настроить процесс конвертации

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

• Какая библиотека обрабатывает конвертацию DGN‑to‑TXT? GroupDocs.Conversion .NET
• Нужна ли лицензия для продакшн‑использования? Да, требуется полная или временная лицензия.
• Можно ли запускать это на .NET 6? Конечно — библиотека поддерживает .NET 5/6, .NET Core 3.1 и .NET Framework 4.5+.
• Как создать папку вывода в C#? Используйте Directory.CreateDirectory(path) перед конвертацией.
• Какова типичная скорость конвертации? Конвертация 200‑страничного DGN в TXT обычно завершается менее чем за 2 секунды на стандартном сервере.

Что такое “create output folder C#”?

Create output folder C# относится к программному обеспечению, гарантирующему, что каталог существует в файловой системе перед записью файлов, обычно с использованием System.IO.Directory.CreateDirectory. Это предотвращает ошибки «путь не найден» при операциях записи файлов.

Почему использовать GroupDocs.Conversion для CAD to TXT?

GroupDocs.Conversion поддерживает более 50 форматов ввода и вывода, включая DGN, DWG и DXF, и может обрабатывать файлы размером до 2 ГБ без загрузки всего документа в память. Его встроенный движок извлечения текста сохраняет имена слоёв, аннотации и атрибутные данные, предоставляя файл TXT, который точно отражает текстовое содержание оригинального чертежа с 99 % точностью.

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

• GroupDocs.Conversion .NET библиотека (версия 25.3.0 или новее)
• Visual Studio 2022 (или любая IDE, поддерживающая C# 8.0+)
• .NET 6 SDK (или .NET Core 3.1 / .NET Framework 4.5+)
• Действительная лицензия GroupDocs (бесплатная пробная версия или временная лицензия подходят для тестирования)

Настройка GroupDocs.Conversion для .NET

Установите библиотеку GroupDocs.Conversion, используя менеджер пакетов по вашему выбору.

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: После установки добавьте файл лицензии в ваш проект и загрузите его при запуске приложения, чтобы избежать ошибок лицензирования во время выполнения.

Базовая инициализация

Класс Converter является основным компонентом GroupDocs.Conversion, который загружает исходные файлы и выполняет преобразования форматов.

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

Руководство по реализации

Как создать папку вывода в C#?

Directory.CreateDirectory создаёт все каталоги и подкаталоги по указанному пути, если они ещё не существуют.

Используйте Directory.CreateDirectory, чтобы убедиться, что путь назначения существует перед вызовом API конвертации. Эта одна строка одновременно создаёт папку, если её нет, и тихо завершает успешно, если папка уже существует, устраняя исключения «каталог не найден» при записи файлов. Она также возвращает полный путь, который можно использовать для логирования или дальнейшей обработки.

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

Загрузка и конвертация файла DGN в TXT

Обзор

Эта функция позволяет загрузить файл DGN и преобразовать его в представление plain‑text (TXT), что удобно для извлечения заметок дизайна, метаданных или встроенных комментариев из архитектурных чертежей.

Шаг 1: Определите путь к каталогу вывода

Укажите, где будут сохраняться ваши конвертированные файлы. Пример ниже создаёт папку ConvertedFiles в корневом каталоге приложения.

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

Почему: Определение отдельного пути вывода помогает поддерживать порядок в проекте и упрощает поиск сгенерированных файлов TXT для последующей обработки.

Шаг 2: Настройте параметры конвертации

Класс TxtConvertOptions содержит настройки, необходимые для конвертации, позволяя настраивать окончания строк, кодировку и включать ли скрытые слои.

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

Что делает: Этот объект указывает конвертеру, как именно формировать текстовое представление, обеспечивая согласованные результаты для разных источников DGN.

Шаг 3: Выполните конвертацию

Выполните конвертацию с ранее определёнными параметрами. Лямбда‑выражение создаёт файл вывода «на лету», избегая временного хранения.

var convertOptions = new TextConvertOptions();

Почему: Использование лямбда‑функции для Save даёт полный контроль над потоком вывода, что особенно полезно при интеграции конвертации в веб‑сервисы или фоновые задачи.

Шаг 4: Запустите конвертацию

Наконец, вызовите метод Convert, передав путь к исходному DGN, целевой формат и объект параметров.

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

Почему: Метод обрабатывает всё низкоуровневое парсинг, извлечение текста и запись файла в одном вызове, освобождая вас от работы с сложными внутренностями CAD.

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

• File Not Found Error: Убедитесь, что путь к файлу DGN является абсолютным или правильно относительным к исполняемому файлу.
• Permission Issues: Убедитесь, что приложение работает под учётной записью с правом записи в папку вывода.
• Conversion Errors: Убедитесь, что версия пакета GroupDocs.Conversion NuGet соответствует версии файла лицензии; несоответствие версий может вызвать ошибки во время выполнения.

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

Эту возможность конвертации можно интегрировать в:

1. Data Extraction: Вытащить текстовые аннотации из чертежей DGN для аналитики или отчетности.
2. Interoperability: Передать извлечённый текст в GIS‑системы, BIM‑базы данных или наследуемые модули ERP, которые принимают только обычный текст.
3. Automation Workflows: Встроить шаг конвертации в конвейеры CI/CD для автоматической генерации документации из файлов дизайна.

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

При обработке больших пакетов файлов CAD, учитывайте следующие рекомендации:

• Optimize Resource Usage: Следите за потреблением памяти; GroupDocs обрабатывает файлы в режиме потоковой передачи, что сохраняет низкое потребление памяти даже для чертежей со многими сотнями страниц.
• Efficient Memory Management: Освобождайте экземпляр Converter после каждой конвертации, чтобы быстро высвободить неуправляемые ресурсы.
• Batch Processing: Используйте Parallel.ForEach для одновременной конвертации нескольких файлов DGN, но ограничьте степень параллелизма, чтобы не перегрузить CPU или пропускную способность ввода‑вывода.

Ресурсы

• документация
• Документация GroupDocs Conversion
• Справочник API GroupDocs Conversion
• Последний релиз
• Купить GroupDocs.Conversion
• Попробовать GroupDocs Conversion бесплатно
• Получить временную лицензию
• Форум GroupDocs

Заключение

Поздравляем! Вы узнали, как create output folder C#, загрузить файл DGN и конвертировать его в TXT с помощью GroupDocs.Conversion .NET. Интегрируя эти шаги в свои приложения, вы упростите извлечение данных, улучшите совместимость и повысите общую продуктивность в ваших CAD‑ориентированных процессах.

Исследуйте дополнительные форматы — такие как DGN → PDF или DGN → DOCX — заменив TxtConvertOptions на соответствующий класс параметров. Пакет GroupDocs предлагает единый API, охватывающий более 50 типов файлов, так что вы можете создать единый, поддерживаемый движок конвертации для всех ваших инженерных документов.

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

Q: Какие форматы файлов поддерживает GroupDocs.Conversion?
A: Более 50 форматов, включая PDF, DOCX, XLSX, DGN, DWG, DXF и TXT.

Q: Есть ли ограничение размера при конвертации файлов DGN?
A: Жёсткого ограничения нет; производительность масштабируется в зависимости от доступной ОЗУ и CPU. Файлы до 2 ГБ надёжно конвертируются на стандартных серверах.

Q: Можно ли настроить кодировку текста выходного TXT?
A: Да — установите свойство Encoding в TxtConvertOptions (например, UTF‑8, ASCII).

Q: Как обрабатывать ошибки конвертации в продакшене?
A: Оберните вызов конвертации в блок try‑catch, логируйте детали ConversionException и при необходимости повторите попытку с альтернативной конфигурацией.

Q: Где можно найти больше примеров и справочники API?
A: Официальная документация и справочник API предоставляют обширные примеры кода и руководства по конфигурации.

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

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

• Как конвертировать файлы DGN в PNG с помощью GroupDocs.Conversion для .NET: Полное руководство
• Как конвертировать файлы DGN в презентации PowerPoint с помощью GroupDocs.Conversion для .NET (Пошаговое руководство)
• Как конвертировать файлы DWG в TXT с помощью GroupDocs.Conversion в .NET: Пошаговое руководство