IBrowserFile.OpenReadStream(Int64, CancellationToken) メソッド

定義

名前空間:

Microsoft.AspNetCore.Components.Forms

アセンブリ:

Microsoft.AspNetCore.Components.Web.dll

パッケージ:

Microsoft.AspNetCore.Components.Web v8.0.0

アップロードされたファイルを読み取るためのストリームを開きます。

public System.IO.Stream OpenReadStream (long maxAllowedSize = 512000, System.Threading.CancellationToken cancellationToken = default);

abstract member OpenReadStream : int64 * System.Threading.CancellationToken -> System.IO.Stream

Public Function OpenReadStream (Optional maxAllowedSize As Long = 512000, Optional cancellationToken As CancellationToken = Nothing) As Stream

パラメーター

maxAllowedSize

Int64

Stream で指定できる最大バイト数。 既定値は 500 KB です。

でSize指定されたファイルのサイズが よりmaxAllowedSize大きい場合、 を呼び出すとOpenReadStream(Int64, CancellationToken)スローされます。 既定では、ユーザーが 500 KB を超えるファイルを指定すると、このメソッドは例外をスローします。

ユース ケースに対応するサイズ制限を選択することは重要です。 過度に大きなファイルを許可すると、指定された Streamでコードが何を行うかに応じて、メモリまたはディスク/データベース領域が過剰に消費される可能性があります。

特に Blazor Server の場合は、サーバー上でそのメモリを消費するため、適切なサイズ制限を超えない限り、ストリーム全体をメモリ バッファーに読み込むことに注意してください。

cancellationToken

CancellationToken

ストリーミング ファイル データの取り消しを通知するキャンセル トークン。

戻り値

Stream

例外

IOException

ファイルの長さが値を超えた場合に maxAllowedSize スローされます。