Struct FileResult 

pub struct FileResult { /* private fields */ }

A file response — ASP.NET Core’s PhysicalFile(...) / File(...) / Results.File(...).

The host streams the source and fills in the HTTP metadata: Content-Length, ETag / Last-Modified validators, Accept-Ranges and Range handling (206 / 416), plus conditional requests (304). Files opened from a path derive their validators from size and mtime; streams become conditional when an entity_tag or last_modified is supplied.

Implementations

impl FileResult

pub fn path(path: impl Into<PathBuf>) -> FileResult

Send the file at path (ASP.NET Core’s PhysicalFile).

pub fn stream(reader: impl AsyncRead + Send + Unpin + 'static) -> FileResult

Send an async reader of unknown length (chunked, no Range).

pub fn seekable_stream( reader: impl AsyncRead + AsyncSeek + Send + Unpin + 'static, len: u64, ) -> FileResult

Send an async reader of known length that supports seeking, so clients can resume and cache (Content-Length, Range).

pub fn with_body(body: FileBody) -> FileResult

Send a fully-specified FileBody.

pub fn content_type(self, content_type: impl Into<String>) -> FileResult

Override the media type instead of deriving it from the extension.

pub fn download_name(self, file_name: impl Into<String>) -> FileResult

Send the file as a download named file_name.

pub fn inline_name(self, file_name: impl Into<String>) -> FileResult

Present the file inline under file_name.

pub fn enable_range_processing(self, enabled: bool) -> FileResult

Enable or disable Range processing for the file source.

pub fn last_modified(self, last_modified: SystemTime) -> FileResult

Advertise an explicit Last-Modified (required for a stream to support If-Modified-Since).

pub fn entity_tag(self, entity_tag: impl Into<String>) -> FileResult

Advertise an explicit ETag (required for a stream to support If-None-Match).

pub fn status(self, status: u16) -> FileResult

Override the HTTP status.

pub fn header( self, key: impl Into<String>, value: impl Into<String>, ) -> FileResult

Add a response header.

Trait Implementations

impl IActionResult for FileResult

fn execute<'life0, 'async_trait>( self: Box<FileResult>, ctx: &'life0 mut dyn IHttpContext, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, FileResult: 'async_trait,

Write this result into the response.