HttpPostedFile Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit l’accès à des fichiers individuels chargés par un client.
public ref class HttpPostedFile sealedpublic sealed class HttpPostedFiletype HttpPostedFile = classPublic NotInheritable Class HttpPostedFile- Héritage
-
HttpPostedFile
Remarques
La HttpFileCollection classe fournit l’accès à tous les fichiers chargés à partir d’un client en tant que collection de fichiers. La HttpPostedFile classe fournit des propriétés et des méthodes pour obtenir des informations sur un fichier individuel et lire et enregistrer le fichier.
Le HtmlInputFile contrôle peut être utilisé pour sélectionner et charger des fichiers à partir d’un client.
Les fichiers sont chargés au format mime multipart/form-data. Par défaut, toutes les requêtes, y compris les champs de formulaire et les fichiers chargés, supérieures à 256 Ko sont mises en mémoire tampon sur le disque, plutôt que conservées dans la mémoire du serveur.
Vous pouvez spécifier la taille de requête maximale autorisée en accédant à la MaxRequestLength propriété ou en définissant l’attribut maxRequestLength de l’élément httpRuntime (schéma de paramètres ASP.NET) dans le fichier Machine.config ou Web.config. La valeur par défaut est de 4 Mo.
La quantité de données mises en mémoire tampon dans la mémoire du serveur pour une requête, qui inclut les chargements de fichiers, peut être spécifiée en accédant à la RequestLengthDiskThreshold propriété ou en définissant l’attribut requestLengthDiskThreshold de l’élément httpRuntime (schéma de paramètres ASP.NET) dans le fichier Machine.config ou Web.config.
En ajustant les propriétés et RequestLengthDiskThreshold les MaxRequestLength propriétés, vous pouvez affiner les performances de votre serveur. En outre, vous devez envisager de définir la définition pour MaxRequestLength empêcher les attaques par déni de service causées par les utilisateurs qui publient des fichiers volumineux sur le serveur.
Les ressources serveur allouées pour mettre en mémoire tampon le fichier chargé sont détruites lorsque la requête se termine. Pour enregistrer une copie durable du fichier, utilisez la SaveAs méthode.
Propriétés
| Nom | Description |
|---|---|
| ContentLength |
Obtient la taille d’un fichier chargé, en octets. |
| ContentType |
Obtient le type de contenu MIME d’un fichier envoyé par un client. |
| FileName |
Obtient le nom complet du fichier sur le client. |
| InputStream |
Obtient un Stream objet qui pointe vers un fichier chargé pour préparer la lecture du contenu du fichier. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| SaveAs(String) |
Enregistre le contenu d’un fichier chargé. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
