IBrowserFile.OpenReadStream(Int64, CancellationToken) Metode

Definisi

Ruang nama:

Microsoft.AspNetCore.Components.Forms

Rakitan:

Microsoft.AspNetCore.Components.Web.dll

Paket:

Microsoft.AspNetCore.Components.Web v8.0.0

Sumber:

IBrowserFile.cs

Membuka aliran untuk membaca file yang diunggah.

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

Parameter

maxAllowedSize

Int64

Jumlah maksimum byte yang dapat disediakan oleh Stream. Defaultnya adalah 500 KB.

OpenReadStream(Int64, CancellationToken) Panggilan akan muncul jika ukuran file, seperti yang ditentukan oleh Size lebih besar dari maxAllowedSize. Secara default, jika pengguna menyediakan file yang lebih besar dari 500 KB, metode ini akan memberikan pengecualian.

Sangat berharga untuk memilih batas ukuran yang sesuai dengan kasus penggunaan Anda. Jika Anda mengizinkan file yang terlalu besar, ini dapat mengakibatkan konsumsi memori atau ruang disk/database yang berlebihan, tergantung pada apa yang dilakukan kode Anda dengan yang disediakan Stream.

Untuk Blazor Server khususnya, berhati-hatilah membaca seluruh aliran ke dalam buffer memori kecuali Anda telah melewati batas ukuran rendah yang sesuai, karena Anda akan mengonsumsi memori itu di server.

cancellationToken

CancellationToken

Token pembatalan untuk memberi sinyal pembatalan data file streaming.

Mengembalikan

Stream

Pengecualian

IOException

Dilemparkan jika panjang file melebihi maxAllowedSize nilai .