HttpPostedFile Classe

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

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

Object

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 para 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 de solicitação permitido acessando a MaxRequestLength propriedade ou definindo o maxRequestLength atributo do elemento httpRuntime (ASP.NET Configurações 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 Configurações Schema) dentro do arquivo Machine.config ou Web.config.

Ao ajustar as propriedades e RequestLengthDiskThreshold as MaxRequestLength propriedades, você pode ajustar o desempenho do servidor. Além disso, você deve considerar a configuração 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)

Confira também

• HtmlInputFile
• HttpFileCollection