groupdocs conversion .net を使用した DGN ファイルの HTML への効率的な変換
DGN ファイルをウェブフレンドリーな HTML 形式に変換することは、特にレイヤー、注釈、複雑なジオメトリを保持する必要がある場合、頭痛の種になります。groupdocs conversion .net は、いくつかの簡潔な C# 呼び出しだけで重い処理を行い、その痛みを取り除きます。このチュートリアルでは、DGN 図面の読み込み、HTML 出力オプションの調整、結果の保存方法を正確に示します—パフォーマンスを考慮しながらです。
クイック回答
- DGN‑to‑HTML 変換を処理するライブラリは何ですか? groupdocs conversion .net
- 使用されている言語は何ですか? C# (.NET Core or .NET Framework)
- テストにライセンスは必要ですか? 評価には無料トライアルで動作しますが、製品環境ではライセンスが必要です。
- 大きな図面を効率的に処理できますか? はい – API はデータをストリーミングし、2 GB 超のファイルをサポートします。
- 完全な API リファレンスはどこで見つけられますか? 以下の公式 GroupDocs ドキュメントにあります。
groupdocs conversion .net とは?
groupdocs conversion .net は、開発者が DGN を含む 100+ のドキュメント、画像、CAD フォーマットをサードパーティ製ソフトウェアなしで PDF、HTML、その他多数の出力形式に変換できる .NET ライブラリです。複雑な図面の処理、レイヤー、線種、テキスト書式の保持を行う統一 API を提供し、デスクトップとサーバー環境の両方に適した高速でメモリ効率の高い変換を実現します。
DGN から HTML への変換に groupdocs conversion .net を使用する理由
速度: ベンチマークでは、標準的な 8 コアサーバーで 500 ページの DGN ファイルの変換が 12 秒未満であることが示されています。メモリ効率: ライブラリはコンテンツをストリーミングするため、マルチギガバイトの図面でもメモリ使用量は 150 MB 未満に抑えられます。精度: MicroStation V8 および V8i の機能をサポートし、生成された HTML でレイヤー、線種、テキスト書式を保持します。
前提条件
- GroupDocs.Conversion for .NET – NuGet または .NET CLI でインストールします(下記参照)。
- Visual Studio 2022 または任意の C# 対応 IDE。
- 基本的な C# の知識とファイル I/O の理解。
GroupDocs.Conversion for .NET の設定
NuGet パッケージのインストール
NuGet パッケージ マネージャ コンソール
Install-Package GroupDocs.Conversion -Version 25.3.0
.NET CLI
dotnet add package GroupDocs.Conversion --version 25.3.0
ライセンス取得
- 無料トライアル: GroupDocs website からダウンロードしてください。
- 一時ライセンス: フル機能を有効にするために一時ライセンスを申請してください。
- 購入: 彼らの purchase page でライセンス購入をご検討ください。
基本的な初期化と設定
まず、必要な名前空間をインポートします:
using GroupDocs.Conversion;
Converter は、ソースドキュメントを読み込み、変換プロセスを統括するメインクラスです。
次に、変換パイプラインを管理する Converter インスタンスを作成します:
string documentPath = "YOUR_DOCUMENT_DIRECTORY\\sample.dgn";
using (var converter = new Converter(documentPath))
{
// Your conversion logic goes here.
}
groupdocs conversion .net を使用して DGN を HTML に変換する方法?
new Converter("source.dgn") で DGN ファイルを読み込み、WebConvertOptions オブジェクトを渡して Convert を呼び出すだけで、わずか 2 行のコードで完全に機能する HTML 表現を生成できます。API はページング、ベクターグラフィック、テキストレンダリングを自動的に処理し、すぐに公開できるウェブページを提供します。
手順 1: DGN ファイルの読み込み
ソース図面へのパスを指定し、コンバータをインスタンス化します:
string documentPath = "YOUR_DOCUMENT_DIRECTORY\\sample.dgn";
手順 2: HTML 変換オプションの設定
WebConvertOptions は、リソースの埋め込みやレイヤー処理など、HTML 出力の設定を定義します。
using (var converter = new Converter(documentPath))
{
// The file is now loaded and ready for conversion.
}
手順 3: 出力ディレクトリの設定
HTML ファイルと関連資産が書き込まれるフォルダーを選択します:
var options = new WebConvertOptions();
手順 4: 変換の実行
Convert は、提供されたオプションを使用して変換を実行し、結果を対象の場所に書き込みます。
string outputFolder = "YOUR_OUTPUT_DIRECTORY";
string outputFile = Path.Combine(outputFolder, "dgn-converted-to.html");
実用的な応用例
- 建築設計の共有 – DGN 図面を HTML に変換し、クライアントが任意のブラウザで即座にプランを確認できるようにします。
- クロスプラットフォーム閲覧 – エンジニアがタブレット、スマートフォン、低電力デバイス上で MicroStation をインストールせずに CAD データを閲覧できるようにします。
- ウェブポータル統合 – ドキュメント管理システムに変換ステップを組み込み、新しい設計の公開を自動化します。
パフォーマンス上の考慮点
- ストリーミング: ライブラリは入力と出力の両方をストリーミングし、マルチギガバイトのファイルでも RAM 使用量を低く抑えます。
- 非同期 API: UI やウェブサービスのシナリオでブロックしないように
ConvertAsyncを使用します。ConvertAsyncは変換を非同期で実行し、Task を返します。 - バッチ処理: DGN ファイルが入ったフォルダーをループし、並列に変換して CPU 使用率を最大化します。
よくある問題と解決策
- フォントが見つからない: 必要な MicroStation フォントがサーバーにインストールされていることを確認してください。インストールされていない場合、API はデフォルトフォントにフォールバックします。
- 大きなファイル (>2 GB):
OutOfMemoryExceptionを回避するためにConversionConfigのMemoryLimitプロパティを増やしてください。ConversionConfigではメモリ制限などのランタイム設定をカスタマイズできます。 - レイアウトが正しくない: レイヤーの可視性を保持するために
WebConvertOptionsのEnableLayers = trueが設定されていることを確認してください。
よくある質問
Q: DGN ファイルとは何ですか?
A: DGN ファイルは、主に MicroStation がエンジニアリングおよび建築設計で使用する CAD 図面フォーマットです。
Q: groupdocs conversion .net で他の CAD フォーマットも変換できますか?
A: はい、ライブラリは DGN に加えて DWG、DXF、IFC など 100 以上のフォーマットをサポートしています。
Q: 大きな図面を効率的に処理するにはどうすればよいですか?
A: ストリーミング API を使用し、非同期変換を有効にし、パフォーマンスセクションで説明したようにメモリ制限を調整してください。
Q: HTML 出力はカスタマイズできますか?
A: もちろんです – WebConvertOptions で CSS の埋め込み、別個の資産フォルダーの選択、ページ番号付けの制御が可能です。
Q: エラーが発生した場合、どこでサポートを受けられますか?
A: コミュニティサポートと公式トラブルシューティングガイドは Help Forum でご確認ください。
リソース
- ドキュメント: GroupDocs Conversion Documentation
- 公式ドキュメント: official documentation
- API リファレンス: Reference Guide
- ダウンロード: Latest Releases
- 購入: Buy Now
- 無料トライアル: Try It Out
- 一時ライセンス: Request Here
- サポートフォーラム: support forum
- ヘルプフォーラム: Help Forum
最終更新日: 2026-06-20
テスト環境: .NET 用 GroupDocs.Conversion 23.12
作者: GroupDocs
using (var converter = new Converter("YOUR_DOCUMENT_DIRECTORY\\sample.dgn"))
{
var options = new WebConvertOptions();
converter.Convert(outputFile, options);
}