C#を使用してZIPアーカイブをレンダリングする

ZIPファイルには、単一のファイルとして機能する1つ以上の圧縮ファイルまたはフォルダーが含まれています。これらは、ストレージスペースを節約し、コンピューターのパフォーマンスを向上させるために広く使用されています。 ZIPアーカイブ内のファイルとフォルダをある場所から別の場所に効果的に転送できます。 C#開発者は、ZIPアーカイブを簡単にレンダリングし、プログラムでコンテンツを表示できます。この記事では、C#を使用してZIPアーカイブをレンダリングする方法に焦点を当てます。

この記事では、次のトピックについて説明/取り上げています。

ZIPファイルを表示するためのC#API
ZIPアーカイブをHTMLでレンダリングする
HTMLでZIPアーカイブから特定のフォルダをレンダリングする
ZIPアーカイブのコンテンツをPDFで表示
ZIPアーカイブをJPGにレンダリング
ZIPアーカイブからフォルダのリストを取得する
ZIPファイルのレンダリングと名前の変更

ZIPファイルを表示するためのC#API

ZIPファイルのレンダリングには、GroupDocs.Viewer for .NETAPIを使用します。これは、170を超えるファイルとドキュメントタイプをサポートする強力なドキュメントビューアAPIです。 APIは、外部ソフトウェアをインストールせずに、広く使用されているファイル形式をどこにでもレンダリングおよび表示するための最も柔軟なドキュメント表示ソリューションを提供します。また、PDF、HTML、XML、Microsoft Office Word、Excelワークシート、PowerPointプレゼンテーション、Outlook電子メール、Visioダイアグラム、プロジェクト、メタファイル、画像、およびその他のさまざまなファイル形式を簡単かつプログラミングの危険性を抑えてすばやく表示できます。

APIのDLLをダウンロードするか、NuGetを使用してインストールできます。

Install-Package GroupDocs.Viewer

ZIPアーカイブをHTMLでレンダリングする

以下に示す簡単な手順に従って、ZIPファイルをHTMLでレンダリングできます。

Viewerクラスのインスタンスを作成します
入力ファイルのパスを指定します
HtmlViewOptionsクラスのインスタンスを作成します
出力ファイルのパスを指定します
View()メソッドを呼び出し、HtmlViewOptionsを渡します

次のコードサンプルは、C#を使用してZIPファイルをHTMLでレンダリングする方法を示しています。

// ビューアを初期化する
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// HTMLビューオプションを定義する
HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("C:\\Files\\output.html");
viewOptions.RenderToSinglePage = true;

// ビューを作成する
viewer.View(viewOptions);

Viewerクラスは、ドキュメントのレンダリングプロセスを制御する機能を提供するメインクラスです。このクラスのView()メソッドは、すべてのドキュメントページのビューを作成します。

HtmlViewOptionsクラスは、ドキュメントをHTML形式にレンダリングするためのオプションを提供します。 ForEmbeddedResourcesコンストラクターメソッドは、埋め込まれたリソースを使用してHTMLにレンダリングするためのHtmlViewOptionsクラスの新しいインスタンスを作成します。ご覧のとおり、コード例で出力ファイルのパスを指定しました。

「ドキュメントHTMLビューア」の詳細については、ドキュメントをご覧ください。

HTMLでZIPアーカイブから特定のフォルダをレンダリングする

以下に示す簡単な手順に従って、ZIPファイル内で使用可能な特定のフォルダーをHTMLでレンダリングできます。

Viewerクラスのインスタンスを作成します
入力ファイルのパスを指定します
HtmlViewOptionsクラスのインスタンスを作成します
出力ファイルのパスを指定します
レンダリングするフォルダ名を設定します
View()メソッドを呼び出し、HtmlViewOptionsを渡します

次のコードサンプルは、C#を使用してHTMLのZIPファイルから特定のフォルダーをレンダリングする方法を示しています。

// ビューアを初期化する
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// HTMLビューオプションを定義する
HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("C:\\Files\\output.html");
// フォルダ名を設定する
viewOptions.ArchiveOptions.Folder = "ThirdFolderWithItems";

// ビューを作成する
viewer.View(viewOptions);

ArchiveOptionsクラスは、アーカイブファイルをレンダリングするためのオプションを提供します。アーカイブ内で使用可能なフォルダーの名前を指定することにより、ZIPアーカイブから特定のフォルダーをレンダリングできます。

ZIPアーカイブのコンテンツをPDFで表示

以下に示す簡単な手順に従って、ZIPファイルをPDFドキュメントでレンダリングできます。

Viewerクラスのインスタンスを作成します
入力ファイルのパスを指定します
PdfViewOptionsクラスのインスタンスを作成します
出力ファイルのパスを指定します
View()メソッドを呼び出し、PdfViewOptionsを渡します

次のコードサンプルは、C#を使用してZIPファイルをPDFでレンダリングする方法を示しています。

// ビューアを初期化する
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// PDF表示オプションを定義する
PdfViewOptions options = new PdfViewOptions("C:\\Files\\output.pdf");

// ビューを作成する
viewer.View(viewOptions);

PdfViewOptionsクラスは、ドキュメントをPDF形式にレンダリングするためのオプションを提供します。「DocumentPDFViewer」の詳細については、ドキュメントを参照してください。

ZIPアーカイブをJPGにレンダリング

以下の簡単な手順に従って、ZIPファイルをJPG画像でレンダリングできます。

Viewerクラスのインスタンスを作成します
入力ファイルのパスを指定します
JpgViewOptionsクラスのインスタンスを作成します
出力ファイルのパスを指定します
View()メソッドを呼び出し、JpgViewOptionsを渡します

次のコードサンプルは、C#を使用してJPG画像でZIPファイルをレンダリングする方法を示しています。

// ビューアを初期化する
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// JPG表示オプションを定義する
JpgViewOptions options = new JpgViewOptions("C:\\Files\\output_page_{0}.jpg");

// ビューを作成する
viewer.View(viewOptions);

ドキュメントをJPGまたはPNG画像形式にレンダリングできます。 JpgViewOptionsクラスは、ドキュメントをJPG形式にレンダリングするためのオプションを提供します。同様に、PngViewOptionsクラスは、ドキュメントをPNG形式にレンダリングするためのオプションを提供します。

「DocumentImageViewer」の詳細については、ドキュメントを参照してください。

ZIPアーカイブからフォルダのリストを取得する

以下の手順に従って、プログラムでZIPファイルからすべてのフォルダーとサブフォルダーのリストを取得できます。

Viewerクラスのインスタンスを作成します
入力ファイルのパスを指定します
ViewInfoOptionsを作成します
GetViewInfo()メソッドを呼び出して、ViewInfoインスタンスを作成します
ArchiveViewInfoを取得します
結果を表示する

次のコードサンプルは、C#を使用してZIPファイルからフォルダーのリストを取得する方法を示しています。

// ビューアを初期化する
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// ビュー情報オプションを作成する
ViewInfoOptions viewInfoOptions = ViewInfoOptions.ForHtmlView();
ViewInfo viewInfo = viewer.GetViewInfo(viewInfoOptions);

Console.WriteLine("File type: " + viewInfo.FileType);
Console.WriteLine("Pages count: " + viewInfo.Pages.Count);
Console.WriteLine("Folders: ");
Console.WriteLine(" - /");

string rootFolder = string.Empty;
viewInfoOptions.ArchiveOptions.Folder = rootFolder;

// ビュー情報を取得する
ArchiveViewInfo viewFolderInfo = viewer.GetViewInfo(viewInfoOptions) as ArchiveViewInfo;

foreach (string subFolder in viewFolderInfo.Folders)
{
    Console.WriteLine($" - {subFolder}");
    PrintFolders(viewer, subFolder);
}

ViewInfoOptionsクラスは、ビューに関する情報を取得するために使用されるオプションを提供します。特定の形式のビュー情報を取得するためのさまざまなメソッドを提供します。 ForHtmlView()メソッドを使用して、ViewInfoOptionsクラスの新しいインスタンスを初期化し、HTMLにレンダリングするときにビューに関する情報を取得しました。

ViewInfoクラスは、汎用ドキュメントのビュー情報を提供します。 ViewerクラスのGetViewInfo()メソッドは、ビューに関する情報とドキュメント固有の情報を返します。

ArchiveViewInfoクラスは、アーカイブファイルのビュー情報を提供します。

ZIPファイルのレンダリングと名前の変更

以下の手順に従って、プログラムでレンダリング中にZIPファイルの名前を変更できます。

Viewerクラスのインスタンスを作成します
入力ファイルのパスを指定します
PdfViewOptionsクラスのインスタンスを作成します
出力ファイルのパスを指定します
表示する新しいファイル名を設定する
View()メソッドを呼び出し、PdfViewOptionsを渡します

次のコードサンプルは、C#を使用してレンダリング中にZIPファイルの名前を変更する方法を示しています。

// ビューアを初期化する
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// PDF表示オプションを定義する
PdfViewOptions viewOptions = new PdfViewOptions("C:\\Files\\output.pdf");
// 新しいファイル名を設定する
viewOptions.ArchiveOptions.FileName = new FileName("MyFiles");

viewer.View(viewOptions);

ArchiveOptionsクラスは、ヘッダーにファイル名を表示するために使用されるFileNameプロパティを提供します。上記のコード例に示すように、新しい表示名を設定できます。デフォルトでは、ソースファイルの名前が表示されます。

無料ライセンスを取得する

無料の一時ライセンスをリクエストすることで、評価の制限なしにAPIを試すことができます。

結論

この記事では、C#を使用してZIPアーカイブをレンダリングする方法を学習しました。また、HTML、PDF、およびJPG画像のZIPファイルのコンテンツを変換および表示する方法も学習しました。さらに、C#でプログラムによってZIPアーカイブからフォルダーとサブフォルダーのリストを取得する方法を学習しました。ドキュメントを使用して、GroupDocs.Viewer for.NETAPIの詳細を確認できます。ご不明な点がございましたら、フォーラムまでお気軽にお問い合わせください。

ZIPファイルを表示するためのC#API#

ZIPアーカイブをHTMLでレンダリングする#

HTMLでZIPアーカイブから特定のフォルダをレンダリングする#

ZIPアーカイブのコンテンツをPDFで表示#

ZIPアーカイブをJPGにレンダリング#

ZIPアーカイブからフォルダのリストを取得する#

ZIPファイルのレンダリングと名前の変更#

無料ライセンスを取得する#

結論#

関連項目#