Partilhar via


HttpPostedFile Classe

Definição

Fornece acesso a arquivos individuais que foram carregados por um cliente.

public ref class HttpPostedFile sealed
public sealed class HttpPostedFile
type HttpPostedFile = class
Public NotInheritable Class HttpPostedFile
Herança
HttpPostedFile

Comentários

A HttpFileCollection classe fornece acesso a todos os arquivos carregados de um cliente como uma coleção de arquivos. A HttpPostedFile classe fornece propriedades e métodos para obter informações sobre um arquivo individual e ler e salvar o arquivo.

O HtmlInputFile controle pode ser usado para selecionar e carregar arquivos de um cliente.

Os arquivos são carregados no formato MIME multipart/form-data. Por padrão, todas as solicitações, incluindo campos de formulário e arquivos carregados, maiores que 256 KB são armazenadas em buffer em disco, em vez de mantidas na memória do servidor.

Você pode especificar o tamanho máximo permitido da solicitação acessando a MaxRequestLength propriedade ou definindo o maxRequestLength atributo do elemento httpRuntime (ASP.NET Settings Schema) dentro do arquivo Machine.config ou Web.config. O padrão é 4 MB.

A quantidade de dados armazenados em buffer na memória do servidor para uma solicitação, que inclui uploads de arquivo, pode ser especificada acessando a RequestLengthDiskThreshold propriedade ou definindo o requestLengthDiskThreshold atributo do elemento httpRuntime (ASP.NET Settings Schema) no arquivo Machine.config ou Web.config.

Ao ajustar as MaxRequestLength propriedades e RequestLengthDiskThreshold , você pode ajustar o desempenho do servidor. Além disso, você deve considerar a configuração de MaxRequestLength para evitar ataques de negação de serviço causados por usuários que postam arquivos grandes no servidor.

Os recursos do servidor alocados para armazenar em buffer o arquivo carregado serão destruídos quando a solicitação terminar. Para salvar uma cópia durável do arquivo, use o SaveAs método .

Propriedades

ContentLength

Obtém o tamanho de um arquivo carregado, em bytes.

ContentType

Obtém o tipo de conteúdo MIME de um arquivo enviado por um cliente.

FileName

Obtém o nome totalmente qualificado do arquivo no cliente.

InputStream

Obtém um objeto Stream que aponta para um arquivo carregado para se preparar para a leitura do conteúdo do arquivo.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
SaveAs(String)

Salva o conteúdo de um arquivo carregado.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também