Blazor.FileSystemAccessダウンロードBlazor.FileSystemAccessソースコードのダウンロード

Blazor.FileSystemAccess

その他のリソース

1.0.0

ダウンロード

導入

ブラウザAPIファイルシステムアクセスのためのBlazorラッパー

APIにより、ファイルとディレクトリの両方のブラウザからローカルファイルシステムに読み書きできるようになります。

免責事項：APIは、限られたブラウザのセットでサポートされています。 Firefox、Android用Chrome、およびiOSモバイルブラウザーではサポートされていない最も目立ちます。

デモ

サンプルプロジェクトは、https：//kristofferstrube.github.io/blazor.filessystemaccess/でデモすることができます

各ページで、右上隅にある例の対応するコードを見つけることができます。

メインページでは、APIが使用済みブラウザで少なくとも最小限のサポートがあるかどうかを確認できます。

ステータスページで、このラッパーがカバーしているWebIDL仕様の量を確認できます。

はじめる

前提条件

ライブラリを使用するには、.NET 7.0以下をインストールする必要があります。

ダウンロード.NET 7

インストール

IDEにパッケージマネージャーを使用して、またはコマンドラインを使用してパッケージマネージャーを使用してNugetを介してパッケージをインストールできます。

dotnet add package KristofferStrube.Blazor.FileSystemAccess

使用法

このパッケージは、Blazor WebAssemblyおよびBlazor Serverプロジェクトで使用できます。（帯域幅の問題により、Blazor Serverでは大きなファイルのストリーミングはサポートされていないことに注意してください。）

輸入

また、ページで使用するためにパッケージを参照する必要があります。これは、以下を追加することで_Import.razorで行うことができます。

 @ using KristofferStrube . Blazor . FileSystemAccess

サービスコレクションに追加します

すべてのページでサービスを利用できるようにする簡単な方法は、 IServiceCollectionに登録して、必要なページに依存関係を注入できるようにすることです。これは、ホストを構築して実行する前に以下を追加することにより、 Program.csで行われます。

 var builder = WebAssemblyHostBuilder . CreateDefault ( args ) ;
builder . RootComponents . Add < App > ( "#app" ) ;
builder . RootComponents . Add < HeadOutlet > ( "head::after" ) ;

// Other services are added.

builder . Services . AddFileSystemAccessService ( ) ;

await builder . Build ( ) . RunAsync ( ) ;

ページに注入します

その後、サービスは次のようなページに挿入できます。

 @inject IFileSystemAccessService FileSystemAccessService ;

その後、 IFileSystemAccessServiceを使用して、このようなファイルSystemAccess APIで利用可能な3つのダイアログのいずれかを開くことができます。

< button @onclick = " OpenAndReadFile " >Open File Picker for Single File and Read</ button >
< br />
@Text

@code {
    private string Text = " " ;

    private async Task OpenAndReadFile ()
    {
        FileSystemFileHandle ? fileHandle = null ;
        try
        {
            OpenFilePickerOptionsStartInWellKnownDirectory options = new ()
                {
                    Multiple = false ,
                    StartIn = WellKnownDirectory . Downloads
                };
            var fileHandles = await FileSystemAccessService . ShowOpenFilePickerAsync ( options );
            fileHandle = fileHandles . Single ();
        }
        catch ( JSException ex )
        {
            // Handle Exception or cancelation of File Access prompt
            Console . WriteLine ( ex );
        }
        finally
        {
            if ( fileHandle is not null )
            {
                var file = await fileHandle . GetFileAsync ();
                Text = await file . TextAsync ();
                StateHasChanged ();
            }
        }
    }
}