GroupDocs.Redaction を使用した .NET でのサポートされているファイル形式の表示

さまざまなドキュメントタイプを管理することは .NET 開発者にとって日常的な現実です。GroupDocs.Redaction を使用すると、ライブラリがサポートする list file extensions を取得でき、アプリケーションはアップロードを受け入れるか拒否するかを判断したり、ユーザーフレンドリーな UI オプションを提示したり、コストのかかるランタイムエラーを回避したりできます。このチュートリアルでは、前提条件から完全な本番環境向け実装まで、必要なすべてを順を追って説明するので、ソリューション内で get file formats と c# display file formats を自信を持って行えるようになります。

クイック回答

  • list file extensions とは何ですか？
    API からサポートされているファイルタイプ識別子（例: .pdf, .docx）のコレクションを取得することを意味します。
  • この機能を提供する NuGet パッケージはどれですか？ GroupDocs.Redaction (latest stable version)。
  • サンプルを実行するのにライセンスは必要ですか？ 開発には無料トライアルライセンスで動作しますが、本番環境では永続ライセンスが必要です。
  • 結果をキャッシュできますか？ はい—リストをメモリまたは分散キャッシュに保存して、繰り返しの API 呼び出しを回避できます。
  • この機能は .NET 6 と .NET Core に対応していますか？ 完全に対応しています。ライブラリは .NET Framework 4.5+、.NET Core 3.1+、.NET 5+、および .NET 6+ をサポートしています。

GroupDocs.Redaction とは何ですか？

GroupDocs.Redaction は、開発者が機密コンテンツをマスクしたり、ドキュメントを変換したり、サポートされているファイルタイプを検出したりできる .NET ライブラリです。サーバー上で Microsoft Office を必要とせずに動作します。複雑なフォーマット処理をクリーンなオブジェクト指向 API の背後に抽象化し、PDF、Office 文書、画像などを扱う統一された API を提供し、高性能とセキュリティを確保します。

GroupDocs.Redaction でファイル拡張子をリストする理由

ライブラリは 50 以上の入力および出力フォーマット をサポートしており、PDF、DOCX、PPTX、XLSX、HTML、30 種類以上の画像形式が含まれます。プログラムで list file extensions を取得することで、以下が可能になります。

  • サポート外のファイルのアップロードを防止し（バリデーションエラーを最大 90% 削減）。
  • ドロップダウンメニューを動的に生成し、ライブラリの更新と UI を同期。
  • ユーザーが処理しようとした正確なファイルタイプを記録する監査ログを構築。

前提条件

  • GroupDocs.Redaction: NuGet からインストールします（下記コマンド参照）。
  • .NET SDK: 最新の .NET SDK がインストールされていることを確認してください。ダウンロードは here から。
  • IDE: Visual Studio 2022 または互換性のあるエディタ。
  • Basic C# knowledge: コレクションと LINQ に慣れていることが望ましい。

.NET 用 GroupDocs.Redaction の設定

ライブラリのインストール

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • NuGet パッケージ マネージャーを開き、 “GroupDocs.Redaction” を検索して最新バージョンをインストールします。

ライセンスの取得と適用

無料トライアルまたは一時ライセンスを取得して、機能制限なしでフル機能を試せます。購入オプションは GroupDocs’ purchase page をご覧ください。ライセンス ファイルを入手したら以下を実行します。

  1. プロジェクト内のアクセス可能なフォルダーに配置します（例: ./Licenses/GroupDocs.Redaction.lic）。
  2. アプリケーション起動時にライセンスを初期化します:

License クラスがライセンス ファイルを読み込み、GroupDocs.Redaction を有効化します。

   using GroupDocs.Redaction.License;
   
   License lic = new License();
   lic.SetLicense("path/to/your/license/file");

GroupDocs.Redaction を使用してファイル拡張子をリストする方法

Redaction API をロードし、サポートされているフォーマットを返すメソッドを呼び出します。この呼び出しは、各項目が拡張子と人間が読める説明を含むコレクションを返します。軽量な操作なので、起動時またはオンデマンドで実行できます。

サポートされているファイルタイプの取得

RedactionApi.GetSupportedFileFormats() メソッドは、各フォーマットを記述する FileFormatInfo オブジェクトの読み取り専用コレクションを返します。

using GroupDocs.Search.Results;
using System;
using System.Collections.Generic;

// Using LINQ to order the supported file formats by their extensions.
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes()
    .OrderBy(ft => ft.Extension);

各拡張子と説明の表示

各 FileFormatInfo はファイルタイプの Extension と Description プロパティを提供します。

foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType.Extension.PadRight(8) + " - " + fileType.Description);
}

Explanation: ループは各 FileFormatInfo オブジェクトを走査し、Extension と Description を整列したテーブル形式で出力します。

リストを UI のドロップダウンに統合する方法

コレクションを取得したら、任意の UI コンポーネント（WinForms ComboBox、WPF ComboBox、ASP.NET Core の select 要素）にバインドします。重要なのは、Extension を値として、Description を表示テキストとして使用することです。これにより、ユーザーは分かりやすい名前を目にしつつ、コード側では正確な拡張子文字列を扱えます。

一般的な問題と解決策

  • Missing namespace error – GroupDocs.Redaction と GroupDocs.Redaction.Common がインポートされていることを確認してください。
  • License not found – ライセンス ファイルのパスが正しいか、ビルド出力に含まれているかを確認します。
  • Performance on large projects – 結果を静的変数または分散キャッシュ（例: Redis）に保存して、繰り返しの列挙を回避します。

実用的な応用例

正確なサポート拡張子リストを把握することで、以下のような実務シナリオが実現できます。

  1. Document Management Systems – 拡張子に基づいて受信ファイルを自動分類。
  2. Content Filtering Tools – アップロード時に許可されていない形式（例: 実行ファイル）をブロック。
  3. File Conversion Pipelines – ファイルが変換可能かどうかを動的に判断し、必要に応じてフォールバック ワークフローへ遷移。

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

  • Memory footprint – フォーマットリストは軽量な IReadOnlyCollection に格納され、通常 2 KB 未満です。
  • Thread safety – コレクションは作成後に不変になるため、同時読み取りで安全です。
  • Caching – 高トラフィック API では、アプリケーションの存続期間中リストをキャッシュし、リクエストごとの数マイクロ秒のオーバーヘッドを排除します。

結論

上記の手順に従うことで、GroupDocs.Redaction を使用して list file extensions と c# display file formats を確実に取得できるようになりました。この機能はユーザー体験を向上させるだけでなく、サポート外ファイルからバックエンドを保護します。コンテンツマスキング、PDF 赤字、バッチ処理など、他の Redaction 機能も活用してドキュメント ワークフローをさらに強化してください。

よくある質問

Q: デフォルトでサポートされているファイル形式は何ですか？
A: GroupDocs.Redaction は 50 以上の形式をサポートしており、PDF、DOCX、PPTX、XLSX、HTML、BMP、JPEG、PNG など多数があります。完全な一覧は GroupDocs documentation を参照してください。

Q: ライブラリを最新バージョンにアップグレードする方法は？
A: NuGet パッケージ マネージャーで “GroupDocs.Redaction” を検索し Update をクリックします。あるいは dotnet add package GroupDocs.Redaction --version <latest> を実行してください。

Q: このリストをサーバー側のアップロードファイル検証に使用できますか？
A: はい—アップロードされたファイルの拡張子を取得したコレクションと比較すれば、処理前に 99% の無効形式エラーを排除できます。

Q: カスタムファイルタイプのサポートを拡張できますか？
A: カスタム拡張子にはカスタムハンドラが必要で、コア ライブラリは新規形式を自動的に追加しません。カスタムインポート/エクスポート パイプラインの作成方法は API ドキュメントをご確認ください。

Q: コード追加後にアプリがクラッシュしました。何を確認すべきですか？
A: ライセンスが正しくロードされているか、using 文が正しい名前空間を参照しているか、ライセンス ファイル読み取り時に IOException を適切にハンドルしているかを確認してください。

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

リソース

関連チュートリアル