Results.Stream 方法

定義

命名空間:

Microsoft.AspNetCore.Http

組件:

Microsoft.AspNetCore.Http.Results.dll

套件:

Microsoft.AspNetCore.App.Ref v8.0.0

多載

Stream(Func<Stream,Task>, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue)	允許直接寫入回應本文。
Stream(PipeReader, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	將指定 PipeReader 的內容寫入回應。 這支援範圍要求（如果無法滿足範圍，Status206PartialContent 或 Status416RangeNotSatisfiable）。
Stream(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	將指定的 Stream 寫入回應。 這支援範圍要求（如果無法滿足範圍，Status206PartialContent 或 Status416RangeNotSatisfiable）。 此 API 是 File(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)的別名。

Stream(Func<Stream,Task>, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue)

來源:

Results.cs

允許直接寫入回應本文。

public static Microsoft.AspNetCore.Http.IResult Stream (Func<System.IO.Stream,System.Threading.Tasks.Task> streamWriterCallback, string? contentType = default, string? fileDownloadName = default, DateTimeOffset? lastModified = default, Microsoft.Net.Http.Headers.EntityTagHeaderValue? entityTag = default);

static member Stream : Func<System.IO.Stream, System.Threading.Tasks.Task> * string * string * Nullable<DateTimeOffset> * Microsoft.Net.Http.Headers.EntityTagHeaderValue -> Microsoft.AspNetCore.Http.IResult

Public Shared Function Stream (streamWriterCallback As Func(Of Stream, Task), Optional contentType As String = Nothing, Optional fileDownloadName As String = Nothing, Optional lastModified As Nullable(Of DateTimeOffset) = Nothing, Optional entityTag As EntityTagHeaderValue = Nothing) As IResult

參數

streamWriterCallback

Func<Stream,Task>

可讓使用者直接寫入響應主體的回呼。

contentType

String

回應的 Content-Type。 預設為 application/octet-stream。

fileDownloadName

String

要用於 Content-Disposition 標頭的檔名。

lastModified

Nullable<DateTimeOffset>

上次修改檔案時的 DateTimeOffset。 用來設定 Last-Modified 回應標頭，並執行條件式範圍要求。

entityTag

EntityTagHeaderValue

要設定 ETag 回應標頭並執行條件式要求的 EntityTagHeaderValue。

傳回

IResult

為回應建立的 IResult。

Stream(PipeReader, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)

來源:

Results.cs

將指定 PipeReader 的內容寫入回應。

這支援範圍要求（如果無法滿足範圍，Status206PartialContent 或 Status416RangeNotSatisfiable）。

public static Microsoft.AspNetCore.Http.IResult Stream (System.IO.Pipelines.PipeReader pipeReader, string? contentType = default, string? fileDownloadName = default, DateTimeOffset? lastModified = default, Microsoft.Net.Http.Headers.EntityTagHeaderValue? entityTag = default, bool enableRangeProcessing = false);

static member Stream : System.IO.Pipelines.PipeReader * string * string * Nullable<DateTimeOffset> * Microsoft.Net.Http.Headers.EntityTagHeaderValue * bool -> Microsoft.AspNetCore.Http.IResult

Public Shared Function Stream (pipeReader As PipeReader, Optional contentType As String = Nothing, Optional fileDownloadName As String = Nothing, Optional lastModified As Nullable(Of DateTimeOffset) = Nothing, Optional entityTag As EntityTagHeaderValue = Nothing, Optional enableRangeProcessing As Boolean = false) As IResult

參數

pipeReader

PipeReader

要寫入回應的 PipeReader。

contentType

String

回應的 Content-Type。 預設為 application/octet-stream。

fileDownloadName

String

要用於 Content-Disposition 標頭的檔名。

lastModified

Nullable<DateTimeOffset>

上次修改檔案時的 DateTimeOffset。 用來設定 Last-Modified 回應標頭，並執行條件式範圍要求。

entityTag

EntityTagHeaderValue

要設定 ETag 回應標頭並執行條件式要求的 EntityTagHeaderValue。

enableRangeProcessing

Boolean

設定為 true 以啟用範圍要求處理。

傳回

IResult

為回應建立的 IResult。

備註

pipeReader 參數會在傳送響應之後完成。

Stream(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)

來源:

Results.cs

將指定的 Stream 寫入回應。

這支援範圍要求（如果無法滿足範圍，Status206PartialContent 或 Status416RangeNotSatisfiable）。

此 API 是 File(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)的別名。

public static Microsoft.AspNetCore.Http.IResult Stream (System.IO.Stream stream, string? contentType = default, string? fileDownloadName = default, DateTimeOffset? lastModified = default, Microsoft.Net.Http.Headers.EntityTagHeaderValue? entityTag = default, bool enableRangeProcessing = false);

static member Stream : System.IO.Stream * string * string * Nullable<DateTimeOffset> * Microsoft.Net.Http.Headers.EntityTagHeaderValue * bool -> Microsoft.AspNetCore.Http.IResult

Public Shared Function Stream (stream As Stream, Optional contentType As String = Nothing, Optional fileDownloadName As String = Nothing, Optional lastModified As Nullable(Of DateTimeOffset) = Nothing, Optional entityTag As EntityTagHeaderValue = Nothing, Optional enableRangeProcessing As Boolean = false) As IResult

參數

stream

Stream

要寫入回應的 Stream。

contentType

String

回應的 Content-Type。 預設為 application/octet-stream。

fileDownloadName

String

要用於 Content-Disposition 標頭的檔名。

lastModified

Nullable<DateTimeOffset>

上次修改檔案時的 DateTimeOffset。 用來設定 Last-Modified 回應標頭，並執行條件式範圍要求。

entityTag

EntityTagHeaderValue

要設定 ETag 回應標頭並執行條件式要求的 EntityTagHeaderValue。

enableRangeProcessing

Boolean

設定為 true 以啟用範圍要求處理。

傳回

IResult

為回應建立的 IResult。

備註

傳送回應之後，會處置 stream 參數。