Преобразование CAD в CSV с помощью GroupDocs.Conversion для .NET

Преобразование CAD файлов в CSV является распространенной задачей, когда необходимо извлечь табличные данные из технических чертежей для анализа, отчетности или миграции. В этом руководстве вы узнаете, как быстро преобразовать CAD в CSV с помощью GroupDocs.Conversion для .NET, шаг за шагом.

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

  • Какая библиотека обрабатывает преобразование? GroupDocs.Conversion for .NET.
  • Какой формат файла читается? Design Web Format (DWF) – a native CAD format.
  • Какой формат вывода? Comma‑Separated Values (CSV) for easy spreadsheet import.
  • Сколько строк кода требуется? Less than ten lines once the library is installed.
  • Нужна ли лицензия для продакшн‑использования? Yes – a commercial license is required for non‑trial use.

Что такое «преобразование CAD в CSV»?

«Convert CAD to CSV» относится к извлечению геометрических или атрибутивных данных из CAD‑чертежа (например, DWF) и записи их в обычный текстовый, разделённый запятыми, таблицу, которую можно открыть в Excel, Power BI или любом инструменте обработки данных. Такое преобразование позволяет аналитикам выполнять статистические расчёты, генерировать отчёты и интегрировать информацию чертежей в базы данных без необходимости специализированного CAD‑ПО.

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

GroupDocs.Conversion поддерживает более 50 форматов ввода и вывода, обрабатывает многосотстраничные CAD‑файлы без загрузки всего документа в память и работает на .NET 6+, .NET 5+, .NET Core 3.1, а также на классическом .NET Framework. Его API не требует внешнего CAD‑ПО, что снижает затраты на лицензирование и упрощает развертывание.

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

Прежде чем начать, убедитесь, что у вас есть следующее:

  • GroupDocs.Conversion for .NET версии 25.3.0 или новее.
  • Среда разработки C# (Visual Studio 2022 или новее).
  • .NET 6 SDK (или любой поддерживаемый .NET runtime).
  • Доступ к действующей лицензии GroupDocs (пробная или приобретённая).

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

  • GroupDocs.Conversion for .NET – основной движок преобразования.
  • System.IO – для работы с путями файлов (встроенный).

Требования к настройке окружения

Ваша ОС должна быть Windows 10/11, macOS 12+ или дистрибутив Linux, поддерживающий целевой .NET runtime.

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

Знание базового синтаксиса C#, операторов using и работы с вводом‑выводом файлов упростит процесс.

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

Как установить библиотеку?

Вы можете добавить GroupDocs.Conversion в ваш проект через NuGet.

Консоль диспетчера пакетов NuGet

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Conversion --version 25.3.0

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

  1. Free Trial: Начните с бесплатной пробной версии, чтобы изучить возможности.
  2. Temporary License: Получите временную лицензию здесь, если вам нужен краткосрочный ключ для тестирования.
  3. Purchase: Для полного продакшн‑использования приобретите лицензию на странице Страница покупки GroupDocs.

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

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

using System;
using GroupDocs.Conversion;

class Program
{
    static void Main()
    {
        string sourceFilePath = @"YOUR_DOCUMENT_DIRECTORY\\sample.dwf";
        var converter = new Converter(sourceFilePath);
        
        Console.WriteLine("GroupDocs.Conversion initialized successfully.");
    }
}

Как преобразовать DWF в CSV с помощью GroupDocs.Conversion для .NET?

Загрузите исходный файл DWF, настройте параметры CSV и вызовите метод Convert — всё преобразование завершается одним вызовом метода. Этот подход автоматически извлекает имена слоёв, координаты и таблицы атрибутов в хорошо структурированный CSV‑файл, а также гарантирует сохранение любой встроенной метаданных для последующего анализа.

Загрузка файла DWF

Обзор

Загрузка файла DWF подготавливает его к преобразованию. Выполните следующие шаги:

Шаг 1: Укажите путь к документу
string sourceFilePath = @"YOUR_DOCUMENT_DIRECTORY\\sample.dwf";

Убедитесь, что sourceFilePath указывает на существующий DWF‑файл на диске.

Шаг 2: Загрузите файл с помощью GroupDocs.Conversion
var converter = new Converter(sourceFilePath);

Преобразование DWF в CSV

Обзор

После загрузки преобразуйте файл DWF в формат CSV.

Шаг 1: Укажите путь вывода для CSV‑файла

Убедитесь, что каталог вывода существует, или создайте его программно:

string outputFolder = @"YOUR_OUTPUT_DIRECTORY";
string outputFile = System.IO.Path.Combine(outputFolder, "dwf-converted-to.csv");
Шаг 2: Подготовьте параметры преобразования для формата CSV

Класс CsvConvertOptions позволяет настроить вывод CSV, например разделитель и кодировку.

using GroupDocs.Conversion.Options.Convert;

SpreadsheetConvertOptions options = new SpreadsheetConvertOptions { Format = GroupDocs.Conversion.FileTypes.SpreadsheetFileType.Csv };
Шаг 3: Выполните преобразование

Выполните преобразование одним вызовом; библиотека обрабатывает разбиение на страницы и очистку ресурсов.

converter.Convert(outputFile, options);
Console.WriteLine("Conversion completed successfully.");

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

  • Убедитесь, что sourceFilePath указывает на читаемый DWF‑файл.
  • Убедитесь, что outputFolder существует; вы можете создать его с помощью Directory.CreateDirectory.
  • Если преобразование не удаётся для больших чертежей, увеличьте лимит памяти процесса или включите режим потоковой передачи через ConversionConfig.EnableStreaming = true.

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

Реальные сценарии, где «преобразование CAD в CSV» проявляет себя:

  1. Architectural Data Analysis: Экспортировать метаданные дизайна в CSV для статистического анализа или оценки стоимости.
  2. Cross‑Platform Compatibility: Перенести данные из проприетарных CAD‑инструментов в форматы, совместимые с Excel, для заинтересованных сторон без CAD‑ПО.
  3. Data Migration Projects: Автоматизировать массовую миграцию устаревших DWF‑чертежей в CSV‑файлы, готовые к загрузке в базу данных.

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

GroupDocs.Conversion обрабатывает файлы в потоковом режиме, позволяя работать с файлами DWF до 1 ГБ без исчерпания ОЗУ. Для оптимальной скорости:

  • Выполняйте преобразование на машине с минимум 4 ГБ свободной ОЗУ.
  • Используйте блоки using, чтобы гарантировать освобождение объекта Converter.

Лучшие практики:

using (var converter = new Converter(sourceFilePath))
{
    // conversion code here
}

using (var converter = new Converter(sourceFilePath))
{
    // Conversion code here
}

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

Q: Как я могу преобразовать другие форматы CAD (DWG, DXF) в CSV?
A: GroupDocs.Conversion поддерживает DWG, DXF и DWF. Замените расширение исходного файла и используйте те же CsvConvertOptions — API автоматически определит формат.

Q: Можно ли пакетно преобразовать несколько файлов DWF за один запуск?
A: Да. Пройдитесь по каталогу с файлами DWF и вызовите логику преобразования для каждого файла внутри цикла foreach.

Q: Какая модель лицензирования применяется к коммерческим проектам?
A: Требуется платная лицензия для любого продакшн‑развёртывания. Пробный ключ работает только для оценки и истекает через 30 дней.

Q: Сохраняет ли преобразование информацию о слоях?
A: Сгенерированный CSV включает столбец “Layer”, который фиксирует оригинальный слой CAD для каждой извлечённой сущности.

Q: Как можно ускорить преобразование очень больших чертежей?
A: Включите потоковую передачу (ConversionConfig.EnableStreaming = true) и запускайте процесс на машине с SSD‑накопителем, чтобы снизить задержку ввода‑вывода.

Заключение

Теперь у вас есть полное, готовое к продакшн‑использованию руководство по преобразованию CAD в CSV с помощью GroupDocs.Conversion для .NET. Следуя приведённым шагам, вы можете интегрировать эту функциональность в любой .NET‑сервис, настольное приложение или автоматизированный конвейер.

Следующие шаги

  • Поэкспериментируйте с дополнительными форматами вывода, такими как XLSX или JSON, используя тот же API.
  • Скомбинируйте вывод CSV с Power BI для создания интерактивных панелей мониторинга ваших CAD‑данных.
  • Ознакомьтесь с полным списком поддерживаемых форматов в документации GroupDocs.

Call to Action: Реализуйте пример кода в вашем следующем проекте и посмотрите, как быстро можно превратить сложные CAD‑чертежи в полезные данные!

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

Ресурсы

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