IBrowserFile.OpenReadStream(Int64, CancellationToken) 메서드

정의

네임스페이스:

Microsoft.AspNetCore.Components.Forms

어셈블리:

Microsoft.AspNetCore.Components.Web.dll

패키지:

Microsoft.AspNetCore.Components.Web v8.0.0

Source:

IBrowserFile.cs

업로드된 파일을 읽기 위한 스트림을 엽니다.

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에서 제공할 수 있는 최대 바이트 수입니다. 기본값은 500KB입니다.

에 지정된 Size 파일의 크기가 보다 maxAllowedSize크면 를 호출 OpenReadStream(Int64, CancellationToken) 하면 이 throw됩니다. 기본적으로 사용자가 500KB보다 큰 파일을 제공하는 경우 이 메서드는 예외를 throw합니다.

사용 사례에 해당하는 크기 제한을 선택하는 것이 중요합니다. 너무 큰 파일을 허용하는 경우 제공된 Stream에서 코드가 수행하는 동작에 따라 메모리 또는 디스크/데이터베이스 공간이 과도하게 소비될 수 있습니다.

특히 Blazor Server의 경우 서버에서 해당 메모리를 사용하므로 적절한 낮은 크기 제한을 통과하지 않는 한 전체 스트림을 메모리 버퍼로 읽는 것이 좋습니다.

cancellationToken

CancellationToken

스트리밍 파일 데이터의 취소를 알리는 취소 토큰입니다.

반환

Stream

예외

IOException

파일의 길이가 값을 초과하면 throw maxAllowedSize 됩니다.