次の方法で共有


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

定義

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

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

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

戻り値

例外

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

適用対象