Results.File Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
File(String, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)
- Origem:
- Results.cs
Grava o arquivo no path especificado na resposta.
Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável).
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 IResultParâmetros
- path
- String
O caminho para o arquivo. Quando não estiver com raiz, resolve o caminho relativo a WebRootFileProvider.
- contentType
- String
O tipo de conteúdo do arquivo.
- fileDownloadName
- String
O nome do arquivo sugerido.
- lastModified
- Nullable<DateTimeOffset>
O DateTimeOffset de quando o arquivo foi modificado pela última vez.
- entityTag
- EntityTagHeaderValue
O EntityTagHeaderValue associado ao arquivo.
- enableRangeProcessing
- Boolean
Defina como true para habilitar o processamento de solicitações de intervalo.
Retornos
O IResult criado para a resposta.
Aplica-se a
File(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)
- Origem:
- Results.cs
Grava o conteúdo da matriz de bytes na resposta.
Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável).
Essa API é um alias para 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 IResultParâmetros
- fileContents
- Byte[]
O conteúdo do arquivo.
- contentType
- String
O tipo de conteúdo do arquivo.
- fileDownloadName
- String
O nome do arquivo sugerido.
- enableRangeProcessing
- Boolean
Defina como true para habilitar o processamento de solicitações de intervalo.
- lastModified
- Nullable<DateTimeOffset>
O DateTimeOffset de quando o arquivo foi modificado pela última vez.
- entityTag
- EntityTagHeaderValue
O EntityTagHeaderValue associado ao arquivo.
Retornos
O IResult criado para a resposta.
Aplica-se a
File(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)
- Origem:
- Results.cs
Grava o Stream especificado na resposta.
Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável).
Essa API é um alias para 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 IResultParâmetros
- contentType
- String
O tipo de conteúdo do arquivo.
- fileDownloadName
- String
O nome do arquivo a ser usado no cabeçalho Content-Disposition.
- lastModified
- Nullable<DateTimeOffset>
O DateTimeOffset de quando o arquivo foi modificado pela última vez.
Usado para configurar o cabeçalho de resposta Last-Modified e executar solicitações de intervalo condicional.
- entityTag
- EntityTagHeaderValue
O EntityTagHeaderValue configurar o cabeçalho de resposta ETag e executar solicitações condicionais.
- enableRangeProcessing
- Boolean
Defina como true para habilitar o processamento de solicitações de intervalo.
Retornos
O IResult criado para a resposta.
Comentários
O parâmetro fileStream é descartado após o envio da resposta.