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.
Donne accès à des fichiers individuels téléchargés par un client.
public ref class HttpPostedFile sealed
public sealed class HttpPostedFile
type HttpPostedFile = class
Public 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 permettant d’obtenir des informations sur un fichier individuel et de lire et d’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 demandes, y compris les champs de formulaire et les fichiers chargés, d’une taille supérieure à 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 Element (ASP.NET Settings Schema) dans le fichier Machine.config ou Web.config. La valeur par défaut est 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 Element (ASP.NET Settings Schema) dans le fichier Machine.config ou Web.config.
En ajustant les MaxRequestLength propriétés et RequestLengthDiskThreshold , vous pouvez affiner les performances de votre serveur. En outre, vous devez envisager de définir pour empêcher les MaxRequestLength attaques par déni de service causées par les utilisateurs qui publient des fichiers volumineux sur le serveur.
Les ressources serveur allouées à la mise en mémoire tampon du fichier chargé sont détruites à la fin de la requête. Pour enregistrer une copie durable du fichier, utilisez la SaveAs méthode .
Propriétés
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 qualifié complet du fichier sur le client. |
InputStream |
Obtient un objet Stream qui pointe vers un fichier chargé pour préparer la lecture du contenu du fichier. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (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) |