HttpPostedFile Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Dá acesso a ficheiros individuais que foram carregados por um cliente.
public ref class HttpPostedFile sealedpublic sealed class HttpPostedFiletype HttpPostedFile = classPublic NotInheritable Class HttpPostedFile- Herança
-
HttpPostedFile
Observações
A HttpFileCollection classe fornece acesso a todos os ficheiros que são carregados a partir de um cliente como uma coleção de ficheiros. A HttpPostedFile classe fornece propriedades e métodos para obter informação sobre um ficheiro individual e para ler e guardar o ficheiro.
O HtmlInputFile controlo pode ser usado para selecionar e carregar ficheiros a partir de um cliente.
Os ficheiros são carregados em formato MIME multipart/form-data. Por defeito, todos os pedidos, incluindo campos de formulário e ficheiros carregados, superiores a 256 KB, são armazenados em buffer no disco, em vez de serem mantidos na memória do servidor.
Pode especificar o tamanho máximo permitido do pedido acedendo à propriedade MaxRequestLength ou definindo o atributo maxRequestLength do elemento httpRuntime Element (ASP.NET Settings Schema) dentro do ficheiro Machine.config ou Web.config. O padrão é 4 MB.
A quantidade de dados que é armazenada em buffer na memória do servidor para um pedido, incluindo carregamentos de ficheiros, pode ser especificada acedendo à propriedade RequestLengthDiskThreshold ou definindo o atributo requestLengthDiskThreshold do elemento httpRuntime Element (ASP.NET Settings Schema) dentro do ficheiro Machine.config ou Web.config.
Ao ajustar as MaxRequestLength propriedades de and RequestLengthDiskThreshold , pode afinar o desempenho do seu servidor. Além disso, deve considerar definir o MaxRequestLength para prevenir ataques de negação de serviço causados por utilizadores que publicam ficheiros grandes no servidor.
Os recursos do servidor alocados para armazenar o ficheiro carregado serão destruídos quando o pedido terminar. Para guardar uma cópia duradoura do ficheiro, use o SaveAs método.
Propriedades
| Name | Description |
|---|---|
| ContentLength |
Obtém o tamanho de um ficheiro carregado, em bytes. |
| ContentType |
Recebe o tipo de conteúdo MIME de um ficheiro enviado por um cliente. |
| FileName |
Obtém o nome totalmente qualificado do ficheiro no cliente. |
| InputStream |
Recebe um Stream objeto que aponta para um ficheiro carregado para se preparar para ler o conteúdo do ficheiro. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| SaveAs(String) |
Guarda o conteúdo de um ficheiro carregado. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |