Results.File Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
- Исходный код:
- 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.IResult
Public 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 для ответа.
Применяется к
- Исходный код:
- 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.IResult
Public 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 для ответа.
Применяется к
- Исходный код:
- 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.IResult
Public 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
EntityTagHeaderValue для настройки заголовка ответа ETag
и выполнения условных запросов.
- enableRangeProcessing
- Boolean
Установите значение true
, чтобы включить обработку запросов диапазона.
Возвращаемое значение
Созданный IResult для ответа.
Комментарии
Параметр fileStream
удаляется после отправки ответа.