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