DGN ファイルを TXT に変換する方法 GroupDocs.Conversion .NET を使用して

はじめに

効率的に create output folder C# を作成し、複雑な DGN ファイルを扱いやすい TXT 形式に変換する方法を探していますか?多くの建築家、エンジニア、建設プロフェッショナルは、レポート作成、データ分析パイプライン、またはレガシーシステムとの統合のために CAD 図面からプレーンテキストデータを抽出する必要があります。このチュートリアルでは、GroupDocs.Conversion .NET を使用して DGN ファイルを読み込み、適切な出力ディレクトリを設定し、クリーンな TXT ファイルを生成する手順を、明確で本番環境向けのコードと共に解説します。

学べること

  • .NET 用 GroupDocs.Conversion のセットアップ方法
  • 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 を使用して、ファイルを書き込む前にファイルシステム上にディレクトリが存在することをプログラムで保証することを指します。これにより、ファイル書き込み操作中の “path not found” エラーを防止できます。

CAD → TXT に GroupDocs.Conversion を使用する理由

GroupDocs.Conversion は 50+ 入出力フォーマット をサポートし、DGN、DWG、DXF などを含み、2 GB までのファイルをメモリ全体にロードせずに処理できます。ネイティブのテキスト抽出エンジンはレイヤー名、注釈、属性データを保持し、元の図面のテキスト内容を 99 % の忠実度 で反映した TXT ファイルを提供します。

前提条件

  • GroupDocs.Conversion .NET ライブラリ(バージョン 25.3.0 以降)
  • Visual Studio 2022(または C# 8.0+ をサポートする任意の IDE)
  • .NET 6 SDK(または .NET Core 3.1 / .NET Framework 4.5+)
  • 有効な GroupDocs ライセンス(無料トライアルまたは一時ライセンスでもテストに使用可能)

.NET 用 GroupDocs.Conversion の設定

パッケージ マネージャーを使用して GroupDocs.Conversion ライブラリをインストールします。

NuGet パッケージ マネージャ コンソール:

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI:

dotnet add package GroupDocs.Conversion --version 25.3.0

プロのヒント: インストール後、ライセンス ファイルをプロジェクトに追加し、アプリケーション開始時にロードしてランタイム ライセンス エラーを回避してください。

基本的な初期化

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 は、指定されたパスにディレクトリが存在しない場合にすべてのディレクトリとサブディレクトリを作成します。

変換 API を呼び出す前に Directory.CreateDirectory を使用して宛先パスが存在することを保証します。この 1 行でフォルダーが存在しない場合は作成され、既に存在する場合は黙って成功するため、ファイル書き込み時の “directory not found” 例外を排除できます。また、完全パスを返すので、ログ記録や後続処理に再利用できます。

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

DGN ファイルをロードして TXT に変換する

概要

この機能は DGN ファイルをロードし、プレーンテキスト(TXT)表現に変換します。設計メモ、メタデータ、埋め込みコメントの抽出に便利です。

手順 1: 出力ディレクトリ パスの定義

変換後のファイルを保存する場所を指定します。以下の例は、アプリケーションのルート ディレクトリに ConvertedFiles というフォルダーを作成します。

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

Why: 専用の出力パスを定義することでプロジェクトが整理され、下流処理用に生成された TXT ファイルを簡単に見つけられるようになります。

手順 2: 変換オプションの設定

TxtConvertOptions クラスは変換に必要な設定を保持し、改行コード、エンコーディング、非表示レイヤーの含めるかどうかをカスタマイズできます。

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

What It Does: このオブジェクトはコンバータにテキスト表現の描画方法を正確に指示し、異なる DGN ソース間で一貫した結果を保証します。

手順 3: 変換の実行

前述のオプションを使用して変換を実行します。ラムダ式は一時的なストレージを使用せずに出力ファイルをオンザフライで作成します。

var convertOptions = new TextConvertOptions();

Why: Save にラムダ式を使用すると出力ストリームを完全に制御でき、Web サービスやバックグラウンド ワーカーへの統合に特に有用です。

手順 4: 変換の実行

最後に Convert メソッドを呼び出し、ソース DGN パス、ターゲット フォーマット、オプション オブジェクトを渡します。

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

Why: このメソッドは低レベルの解析、テキスト抽出、ファイル書き込みをすべて 1 回の呼び出しで処理し、複雑な CAD の内部構造に対処する必要をなくします。

よくある問題と解決策

  • File Not Found Error: DGN ファイルのパスが絶対パスか、実行ファイルに対して正しく相対パスになっているか確認してください。
  • Permission Issues: アプリケーションが出力フォルダーへの書き込み権限を持つアカウントで実行されていることを確認してください。
  • Conversion Errors: GroupDocs.Conversion NuGet パッケージのバージョンがライセンス ファイルのバージョンと一致しているか確認してください。バージョンが一致しないとランタイム エラーが発生する可能性があります。

実用的な活用例

  1. データ抽出: DGN 図面からテキスト注釈を取得し、分析やレポートに活用します。
  2. 相互運用性: 抽出したテキストを GIS システム、BIM データベース、またはプレーンテキスト入力のみを受け付けるレガシー ERP モジュールに供給します。
  3. 自動化ワークフロー: CI/CD パイプラインに変換ステップを組み込み、設計ファイルから自動的にドキュメントを生成します。

パフォーマンス上の考慮点

  • リソース使用の最適化: メモリ使用量を監視してください。GroupDocs はストリーミング モードでファイルを処理するため、数百ページの図面でもメモリ フットプリントが低く抑えられます。
  • 効率的なメモリ管理: 各変換後に Converter インスタンスを破棄し、アンマネージド リソースを速やかに解放してください。
  • バッチ処理: Parallel.ForEach を使用して複数の DGN ファイルを同時に変換できますが、CPU や I/O 帯域幅を使い果たさないように並列度を制限してください。

リソース

結論

おめでとうございます!create output folder C# の方法、DGN ファイルのロード、そして GroupDocs.Conversion .NET を使用した TXT への変換手順を習得しました。これらの手順をアプリケーションに組み込むことで、データ抽出を効率化し、相互運用性を向上させ、CAD 中心のワークフロー全体の生産性を向上させることができます。

TxtConvertOptions を適切なオプション クラスに置き換えることで、DGN → PDF や DGN → DOCX などの追加フォーマットも簡単に扱えます。GroupDocs スイートは 50 種類以上のファイルタイプをカバーする統一 API を提供しているため、すべてのエンジニアリング ドキュメントに対して単一の保守しやすい変換エンジンを構築できます。

よくある質問

Q: GroupDocs.Conversion はどのファイル形式をサポートしていますか?
A: PDF、DOCX、XLSX、DGN、DWG、DXF、TXT など、50 種類以上の形式をサポートしています。

Q: DGN ファイルの変換にサイズ制限はありますか?
A: ハードな上限はありません。パフォーマンスは利用可能な RAM と CPU に比例します。標準サーバー上で最大 2 GB のファイルでも安定して変換できます。

Q: 出力 TXT のテキストエンコーディングはカスタマイズできますか?
A: はい、TxtConvertOptionsEncoding プロパティを設定すれば、UTF‑8、ASCII など任意のエンコーディングを指定できます。

Q: 本番環境で変換エラーが発生した場合の対処方法は?
A: 変換呼び出しを try‑catch ブロックで囲み、ConversionException の詳細をログに記録し、必要に応じてフォールバック設定で再試行してください。

Q: さらに多くのサンプルや API リファレンスはどこで入手できますか?
A: 公式ドキュメントと API リファレンスに豊富なコードサンプルと設定ガイドが掲載されています。

最終更新日: 2026-07-06
テスト環境: GroupDocs.Conversion .NET 25.3.0
作者: GroupDocs

関連チュートリアル