Results.File Метод

Определение

Перегрузки

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

Записывает файл по указанному path в ответ.

Это поддерживает запросы диапазона (Status206PartialContent или Status416RangeNotSatisfiable, если диапазон не удовлетворяется).

File(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)

Записывает содержимое массива байтов в ответ.

Это поддерживает запросы диапазона (Status206PartialContent или Status416RangeNotSatisfiable, если диапазон не удовлетворяется).

Этот API является псевдонимом для Bytes(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue).

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

Записывает указанный Stream в ответ.

Это поддерживает запросы диапазона (Status206PartialContent или Status416RangeNotSatisfiable, если диапазон не удовлетворяется).

Этот API является псевдонимом для Stream(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean).

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);

Параметры

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);

Параметры

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);

Параметры

fileStream
Stream

Stream с содержимым файла.

contentType
String

Тип контента файла.

fileDownloadName
String

Имя файла, используемое в заголовке Content-Disposition.

lastModified
Nullable<DateTimeOffset>

DateTimeOffset момента последнего изменения файла. Используется для настройки заголовка ответа Last-Modified и выполнения запросов условного диапазона.

entityTag
EntityTagHeaderValue

EntityTagHeaderValue для настройки заголовка ответа ETag и выполнения условных запросов.

enableRangeProcessing
Boolean

Установите значение true, чтобы включить обработку запросов диапазона.

Возвращаемое значение

Созданный IResult для ответа.

Комментарии

Параметр fileStream удаляется после отправки ответа.

Применяется к