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

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

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

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

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

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

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

Stream

IOException

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