HttpPostedFile Classe

Définition

Donne accès à des fichiers individuels téléchargés par un client.Provides access to individual files that have been uploaded by a 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 qui sont téléchargés à partir d’un client sous la forme d’une collection de fichiers.The HttpFileCollection class provides access to all the files that are uploaded from a client as a file collection. 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.The HttpPostedFile class provides properties and methods to get information about an individual file and to read and save the file.

Le HtmlInputFile contrôle peut être utilisé pour sélectionner et charger des fichiers à partir d’un client.The HtmlInputFile control can be used to select and upload files from a client.

Les fichiers sont téléchargés au format MIME multipart/form-Data.Files are uploaded in MIME multipart/form-data format. Par défaut, toutes les demandes, y compris les champs de formulaire et les fichiers téléchargés, d’une taille supérieure à 256 Ko sont mises en mémoire tampon sur le disque, au lieu d’être conservées dans la mémoire du serveur.By default, all requests, including form fields and uploaded files, larger than 256 KB are buffered to disk, rather than held in server memory.

Vous pouvez spécifier la taille maximale des demandes autorisées en accédant à MaxRequestLength la propriété ou en définissant l' maxRequestLength attribut de l’élément httpRuntime (schéma des paramètres ASP.net) dans le fichier machine. config ou Web. config.You can specify the maximum allowable request size by accessing the MaxRequestLength property or by setting the maxRequestLength attribute of the httpRuntime Element (ASP.NET Settings Schema) element within the Machine.config or Web.config file. La valeur par défaut est 4 Mo.The default is 4 MB.

Vous pouvez spécifier la quantité de données mises en mémoire tampon dans la mémoire du serveur pour une demande, notamment les chargements de fichiers, en accédant à la RequestLengthDiskThreshold propriété ou en définissant l' requestLengthDiskThreshold attribut de l' élément httpRuntime (schéma des paramètres ASP.net) dans le fichier machine. config ou Web. config.The amount of data that is buffered in server memory for a request, which includes file uploads, can be specified by accessing the RequestLengthDiskThreshold property or by setting the requestLengthDiskThreshold attribute of the httpRuntime Element (ASP.NET Settings Schema) element within the Machine.config or Web.config file.

En ajustant MaxRequestLength les RequestLengthDiskThreshold propriétés et, vous pouvez ajuster les performances de votre serveur.By adjusting the MaxRequestLength and RequestLengthDiskThreshold properties, you can fine tune the performance of your server. En outre, vous devez envisager de définir MaxRequestLength le pour empêcher les attaques par déni de service causées par les utilisateurs qui publient des fichiers volumineux sur le serveur.Additionally, you should consider setting the MaxRequestLength to prevent denial of service attacks caused by users posting large files to the server.

Les ressources serveur allouées à la mise en mémoire tampon du fichier téléchargé sont détruites à la fin de la demande.Server resources that are allocated to buffer the uploaded file will be destroyed when the request ends. Pour enregistrer une copie durable du fichier, utilisez la SaveAs méthode.To save a durable copy of the file, use the SaveAs method.

Propriétés

ContentLength

Obtient la taille d’un fichier chargé, en octets.Gets the size of an uploaded file, in bytes.

ContentType

Obtient le type de contenu MIME d'un fichier envoyé par un client.Gets the MIME content type of a file sent by a client.

FileName

Obtient le nom qualifié complet du fichier côté client.Gets the fully qualified name of the file on the client.

InputStream

Obtient un objet Stream qui pointe vers un fichier téléchargé afin de préparer la lecture du contenu de ce fichier.Gets a Stream object that points to an uploaded file to prepare for reading the contents of the file.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
SaveAs(String)

Enregistre le contenu d'un fichier téléchargé.Saves the contents of an uploaded file.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi