Results.File 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
File(String, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)
- 來源:
- Results.cs
將位於指定 path 的檔案寫入回應。
這支援範圍要求（如果無法滿足範圍，Status206PartialContent 或 Status416RangeNotSatisfiable）。
public static Microsoft.AspNetCore.Http.IResult File (string path, string? contentType = default, string? fileDownloadName = default, DateTimeOffset? lastModified = default, Microsoft.Net.Http.Headers.EntityTagHeaderValue? entityTag = default, bool enableRangeProcessing = false);static member File : string * string * string * Nullable<DateTimeOffset> * Microsoft.Net.Http.Headers.EntityTagHeaderValue * bool -> Microsoft.AspNetCore.Http.IResultPublic Shared Function File (path As String, 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參數
- path
- String
檔案的路徑。 未建立根目錄時，會解析相對於 WebRootFileProvider的路徑。
- contentType
- String
檔案的內容類型。
- fileDownloadName
- String
建議的檔名。
- lastModified
- Nullable<DateTimeOffset>
上次修改檔案時的 DateTimeOffset。
- entityTag
- EntityTagHeaderValue
與檔案相關聯的 EntityTagHeaderValue。
- enableRangeProcessing
- Boolean
設定為 true 以啟用範圍要求處理。
傳回
為回應建立的 IResult。
適用於
File(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)
- 來源:
- Results.cs
將位元組數位內容寫入回應。
這支援範圍要求（如果無法滿足範圍，Status206PartialContent 或 Status416RangeNotSatisfiable）。
此 API 是 Bytes(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)的別名。
public static Microsoft.AspNetCore.Http.IResult File (byte[] fileContents, string? contentType = default, string? fileDownloadName = default, bool enableRangeProcessing = false, DateTimeOffset? lastModified = default, Microsoft.Net.Http.Headers.EntityTagHeaderValue? entityTag = default);static member File : byte[] * string * string * bool * Nullable<DateTimeOffset> * Microsoft.Net.Http.Headers.EntityTagHeaderValue -> Microsoft.AspNetCore.Http.IResultPublic Shared Function File (fileContents As Byte(), Optional contentType As String = Nothing, Optional fileDownloadName As String = Nothing, Optional enableRangeProcessing As Boolean = false, Optional lastModified As Nullable(Of DateTimeOffset) = Nothing, Optional entityTag As EntityTagHeaderValue = Nothing) As IResult參數
- fileContents
- Byte[]
檔案內容。
- contentType
- String
檔案的內容類型。
- fileDownloadName
- String
建議的檔名。
- enableRangeProcessing
- Boolean
設定為 true 以啟用範圍要求處理。
- lastModified
- Nullable<DateTimeOffset>
上次修改檔案時的 DateTimeOffset。
- entityTag
- EntityTagHeaderValue
與檔案相關聯的 EntityTagHeaderValue。
傳回
為回應建立的 IResult。
適用於
File(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)
- 來源:
- Results.cs
將指定的 Stream 寫入回應。
這支援範圍要求（如果無法滿足範圍，Status206PartialContent 或 Status416RangeNotSatisfiable）。
此 API 是 Stream(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)的別名。
public static Microsoft.AspNetCore.Http.IResult File (System.IO.Stream fileStream, string? contentType = default, string? fileDownloadName = default, DateTimeOffset? lastModified = default, Microsoft.Net.Http.Headers.EntityTagHeaderValue? entityTag = default, bool enableRangeProcessing = false);static member File : System.IO.Stream * string * string * Nullable<DateTimeOffset> * Microsoft.Net.Http.Headers.EntityTagHeaderValue * bool -> Microsoft.AspNetCore.Http.IResultPublic Shared Function File (fileStream 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參數
- contentType
- String
檔案的內容類型。
- fileDownloadName
- String
要用於 Content-Disposition 標頭的檔名。
- lastModified
- Nullable<DateTimeOffset>
上次修改檔案時的 DateTimeOffset。
用來設定 Last-Modified 回應標頭，並執行條件式範圍要求。
- entityTag
- EntityTagHeaderValue
要設定 ETag 回應標頭並執行條件式要求的 EntityTagHeaderValue。
- enableRangeProcessing
- Boolean
設定為 true 以啟用範圍要求處理。
傳回
為回應建立的 IResult。
備註
傳送回應之後，會處置 fileStream 參數。