IRONZIPの使用

.NET MAUIデータ抽出SDK with IronZIP

公開済み 2023年12月12日

共有:

イントロダクション

.NET MAUI（.NET Multi-platform App UI）は、クロスプラットフォームアプリケーションを構築するためのフレームワークです。開発者は、Windows、macOS、iOS、Android、その他あらゆるデバイス上で動作するアプリケーションを単一のコードベースで作成することができる。リアクト・ネイティブに似ているが、JavaScriptの代わりにC#（シーシャープ）で動作する。

.NET MAUIにより、C#（シーシャープ）開発者は、単一の環境から手間のかからないモバイルアプリケーションやデスクトップアプリを構築できます。 Microsoft .NET MAUIは、開発者がアプリ開発プロセスを容易にし、最適化できるよう、本格的なドキュメントとリソースを提供します。

この記事では、データ抽出の目的で.NET MAUIと連携する強力なC# ZIPアーカイブライブラリのIronZIPについて探ります。

Zipアーカイブからデータを抽出する方法

Visual Studio .NET MAUIプロジェクトの作成
NuGetを使用したC# Zipライブラリのインストール
データ抽出アプリのインターフェースをデザインする
Zip作成メソッドとZip展開メソッドの実装
アプリケーションを実行し、結果を確認する

IronZIPの紹介

IronZIPは、.NETでアーカイブを作成、読み取り、抽出するために設計された包括的なC#（シーシャープ）ZIPアーカイブライブラリです。 ZIP、TAR、GZIP、BZIP2を含む幅広いアーカイブ形式をサポートしています。IronZIPは.NET 7、6、5、コア、スタンダード、フレームワークなどの様々な.NETバージョンと互換性があります。

クロスプラットフォームなので、Windows、Linux、Mac、iOS、Android、Docker、Azure、AWS上で動作するC#、F#、VB.NETアプリケーションに適しています。

IronZIPの主な特徴は以下の通りです：

様々なOSに対応するクロスプラットフォーム。
異なる.NETバージョンやプロジェクトタイプとの互換性。
ZIP、TAR、GZIP、BZIP2アーカイブの作成、読み込み、解凍をサポート。
.NET MAUIとの統合により、マルチプラットフォームアプリケーションを構築。

前提条件

始める前に、以下の前提条件が揃っていることを確認してください：

1.ビジュアルスタジオ.NET MAUIワークロードがインストールされている。

.NET MAUIプロジェクトにIronZIPライブラリを追加。

Visual Studioで.NET MAUIアプリケーションを作成する手順

Visual Studioを開き、"Create a New project "をクリックする。
.NET MAUI App プロジェクト・テンプレートを選択し、Next をクリックします。
プロジェクト設定、プロジェクト名、場所を設定する。次へ進む。
Additional Informationから、正しい.NETフレームワークを選択します。 IronZIPは.NETフレームワークの最新バージョンをサポートしています。
Create をクリックして、IronZIP ライブラリを使用した .NET MAUI App for Zip Data Extraction (.NET 用アイアン ZIP) を作成します。

IronZIPのインストール

IronZIPを.NET MAUIプロジェクトに統合するには、以下の手順に従ってください：

ビューからソリューションエクスプローラーを開く。
ソリューションエクスプローラーでプロジェクトを右クリックします。
Manage NuGet Packages for Solution "を選択します。
NuGetブラウズタブで "IronZIP "を検索し、プロジェクトのパッケージをインストールする。
Preview Changesダイアログボックスで、"Apply "をクリックして変更を行い、"Accept "をクリックしてIronZIPライセンスを承認します。
NuGetがインストールを終了し、確認メッセージが表示されます。

さて、すべてのインストールとセットアップが完了したので、.NET MAUIでZip Extractorを作成するデータ抽出タスクに移りましょう。

Zip Extractorの作成手順

ステップ1 アプリのインターフェースをデザインする

このセクションでは、.NET MAUIアプリケーションのユーザーインターフェースの設計に焦点を当てます。プロジェクト・フォルダ内のMainPage.xamlファイルを開き、ユーザーフレンドリーなインターフェイスを作成するために必要なXAMLコードを追加します。

1つはzipファイルを作成するためのボタン、もう1つはzipファイルを展開するためのボタンです。適切なメッセージを伝えるために、いくつかのラベルも必要である。次のコード例は、デザインのxamlコードを示しています：

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiAppDataExtraction.MainPage">
    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">
            <Label
                Text="IronZIP - A Zip Library to Create and Extract Zip Content!"
                SemanticProperties.HeadingLevel="Level1"
                FontSize="32"
                HorizontalOptions="Center" />
            <Label
                Text="Welcome to .NET Multi-platform App UI"
                SemanticProperties.HeadingLevel="Level2"
                SemanticProperties.Description="Welcome to dot net Multi platform App U I"
                FontSize="18"
                HorizontalOptions="Center" />
            <Button
                x:Name="OpenFileBtn"
                Text="Extract Zip File"
                SemanticProperties.Hint="Opens the File Picker"
                Clicked="OnSelectFileButtonClicked"
                HorizontalOptions="Center" />
            <Button
                 x:Name="OpenFilesBtn"
                 Text="Create Zip"
                 SemanticProperties.Hint="Opens the File Picker"
                 Clicked="OnSelectFilesButtonClicked"
                 HorizontalOptions="Center" />  
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiAppDataExtraction.MainPage">
    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">
            <Label
                Text="IronZIP - A Zip Library to Create and Extract Zip Content!"
                SemanticProperties.HeadingLevel="Level1"
                FontSize="32"
                HorizontalOptions="Center" />
            <Label
                Text="Welcome to .NET Multi-platform App UI"
                SemanticProperties.HeadingLevel="Level2"
                SemanticProperties.Description="Welcome to dot net Multi platform App U I"
                FontSize="18"
                HorizontalOptions="Center" />
            <Button
                x:Name="OpenFileBtn"
                Text="Extract Zip File"
                SemanticProperties.Hint="Opens the File Picker"
                Clicked="OnSelectFileButtonClicked"
                HorizontalOptions="Center" />
            <Button
                 x:Name="OpenFilesBtn"
                 Text="Create Zip"
                 SemanticProperties.Hint="Opens the File Picker"
                 Clicked="OnSelectFilesButtonClicked"
                 HorizontalOptions="Center" />  
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

XML

アプリケーションを実行すると、画面上に通常のウィンドウズ・フォームとして出力されます。

.NET MAUIデータ抽出SDK（開発者向けチュートリアル）：図7

ステップ2 コードの実装

1.ジップ作成

MainPage.xaml.csファイルを開き、".[ジップを作成する](/csharp/zip/examples/create-zip/)"機能である。 OnSelectFilesButtonClickedメソッドを実装して、FilePickerを開き、zipファイルを作成するために任意のタイプの複数のファイルを選択できるようにします。

次に、選択したファイルからすべてのパスのリストを作成する。最後にそれをCreateZipメソッドに渡すと、IronZIPは1秒以内にシームレスにすべてのファイルパスを使用してzipファイルを作成します。

次のコード例は、このタスクを達成する方法を示している。

private async void OnSelectFilesButtonClicked(object sender, EventArgs e)
{
    try
    {
        var status = await Permissions.RequestAsync<Permissions.StorageRead>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Alert!", "Storage Access Denied", "Ok");
            return;
        }
        // Select Multiple files of any type
        var results = await FilePicker.PickMultipleAsync();
        if (results != null)
        {
            var selectedFilePaths = new List<string>();
            foreach (var file in results)
            {
                // Add File Full Path to the list one by one
                selectedFilePaths.Add(file.FullPath);
            }
            CreateZip(selectedFilePaths);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

private async void OnSelectFilesButtonClicked(object sender, EventArgs e)
{
    try
    {
        var status = await Permissions.RequestAsync<Permissions.StorageRead>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Alert!", "Storage Access Denied", "Ok");
            return;
        }
        // Select Multiple files of any type
        var results = await FilePicker.PickMultipleAsync();
        if (results != null)
        {
            var selectedFilePaths = new List<string>();
            foreach (var file in results)
            {
                // Add File Full Path to the list one by one
                selectedFilePaths.Add(file.FullPath);
            }
            CreateZip(selectedFilePaths);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

Private Async Sub OnSelectFilesButtonClicked(ByVal sender As Object, ByVal e As EventArgs)
	Try
		Dim status = Await Permissions.RequestAsync(Of Permissions.StorageRead)()
		If status <> PermissionStatus.Granted Then
			Await DisplayAlert("Alert!", "Storage Access Denied", "Ok")
			Return
		End If
		' Select Multiple files of any type
		Dim results = Await FilePicker.PickMultipleAsync()
		If results IsNot Nothing Then
			Dim selectedFilePaths = New List(Of String)()
			For Each file In results
				' Add File Full Path to the list one by one
				selectedFilePaths.Add(file.FullPath)
			Next file
			CreateZip(selectedFilePaths)
		End If
	Catch ex As Exception
		Console.WriteLine($"Error: {ex.Message}")
	End Try
End Sub

VB C#

ここで、IronZIPのIronArchiveクラスは作成されるZIPファイル名のパスを受け取ります。選択された各ファイルパスをループし、Add メソッドによってZIPファイルに追加される。

ファイルが追加されると、DisplayAlertを使って確認メッセージが表示される。

private async void CreateZip(List<string> selectedFilePaths)
{
    var path = "E:\\output.zip";
    // Create a Zip
    using (var archive = new IronArchive(path))
    {
        // Add files to the ZIP
        foreach (var file in selectedFilePaths)
        {
            archive.Add(file);
        }
    }
    await DisplayAlert("Congratulations", "All files add to the " + path, "Ok");
}

private async void CreateZip(List<string> selectedFilePaths)
{
    var path = "E:\\output.zip";
    // Create a Zip
    using (var archive = new IronArchive(path))
    {
        // Add files to the ZIP
        foreach (var file in selectedFilePaths)
        {
            archive.Add(file);
        }
    }
    await DisplayAlert("Congratulations", "All files add to the " + path, "Ok");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

ZIPの作成方法、既存のZIPへのファイルの追加方法、ZIPの解凍方法の詳細については、こちらをご覧ください。**チュートリアルページ.

2.zipを展開する

では、"Zipを取り出す"機能である。再度、MainPage.xaml.cs ファイルで、OnSelectFileButtonClicked メソッドを実装して、FilePicker を開き、抽出する zip ファイルを 1 つ選択できるようにします。

選択されたファイルのフルパスは文字列変数にセットされ、IronZIPが抽出を行うExtractZipメソッドに送られる。コードは次のようになります：

private async void OnSelectFileButtonClicked(object sender, EventArgs e)
{
    try
    {
        var status = await Permissions.RequestAsync<Permissions.StorageRead>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Alert!", "Storage Access Denied", "Ok");
            return;
        }
        // Select Multiple files of any type
        var result = await FilePicker.PickAsync();
        if (result != null)
        {
            // Add File Full Path to the list one by one
            var selectedFile = result.FullPath;
            ExtractZip(selectedFile);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

private async void OnSelectFileButtonClicked(object sender, EventArgs e)
{
    try
    {
        var status = await Permissions.RequestAsync<Permissions.StorageRead>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Alert!", "Storage Access Denied", "Ok");
            return;
        }
        // Select Multiple files of any type
        var result = await FilePicker.PickAsync();
        if (result != null)
        {
            // Add File Full Path to the list one by one
            var selectedFile = result.FullPath;
            ExtractZip(selectedFile);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

Private Async Sub OnSelectFileButtonClicked(ByVal sender As Object, ByVal e As EventArgs)
	Try
		Dim status = Await Permissions.RequestAsync(Of Permissions.StorageRead)()
		If status <> PermissionStatus.Granted Then
			Await DisplayAlert("Alert!", "Storage Access Denied", "Ok")
			Return
		End If
		' Select Multiple files of any type
		Dim result = Await FilePicker.PickAsync()
		If result IsNot Nothing Then
			' Add File Full Path to the list one by one
			Dim selectedFile = result.FullPath
			ExtractZip(selectedFile)
		End If
	Catch ex As Exception
		Console.WriteLine($"Error: {ex.Message}")
	End Try
End Sub

VB C#

では、ExtractZip メソッドを作成しましょう。この方法では、ファイルを抽出する出力フォルダのパスを設定します。

IronZIPのExtractArchiveToDirectoryメソッドを使用して、選択されたファイルパスと出力パスを渡します。この方法では、zip内のすべてのファイルをシームレスに変換し、出力フォルダに転送します。最後に、抽出に成功すると確認メッセージが表示される。

コードは次のようになります：

private async void ExtractZip(string selectedFilePath)
{
    var path = "E:\\Extracted Files";
    IronArchive.ExtractArchiveToDirectory(selectedFilePath, path);
    await DisplayAlert("Congratulations", "All files extracted to the " + path, "Ok");
}

private async void ExtractZip(string selectedFilePath)
{
    var path = "E:\\Extracted Files";
    IronArchive.ExtractArchiveToDirectory(selectedFilePath, path);
    await DisplayAlert("Congratulations", "All files extracted to the " + path, "Ok");
}

Private Async Sub ExtractZip(ByVal selectedFilePath As String)
	Dim path = "E:\Extracted Files"
	IronArchive.ExtractArchiveToDirectory(selectedFilePath, path)
	Await DisplayAlert("Congratulations", "All files extracted to the " & path, "Ok")
End Sub

VB C#