HttpFileCollection Classe

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

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 aux fichiers chargés par un client et les organise.

public ref class HttpFileCollection sealed : System::Collections::Specialized::NameObjectCollectionBase

public sealed class HttpFileCollection : System.Collections.Specialized.NameObjectCollectionBase

type HttpFileCollection = class
    inherit NameObjectCollectionBase

Public NotInheritable Class HttpFileCollection
Inherits NameObjectCollectionBase

Héritage: Object

NameObjectCollectionBase
HttpFileCollection

Exemples

L’exemple suivant montre comment accéder à la HttpFileCollection collection retournée à partir de la Files propriété de l’objet HttpRequest . La HttpFileCollection collection est remplie par deux FileUpload contrôles sur la page Web. Les éléments de la collection de fichiers sont affichés dans un BulletedList contrôle.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        // Clear the BulletedList.
        BulletedList1.Items.Clear();
        
        // Check to see if at least one file was specified.
        if (FileUpload1.HasFile | FileUpload2.HasFile)
        {
            Label1.Text = "The file collection consists of:";
            
            // Get the HttpFileCollection.
            HttpFileCollection hfc = Request.Files;
            foreach (String h in hfc.AllKeys)
            {
                // Add an item to the BulletedList if a file
                // was specified for the corresponding control.
                if (hfc[h].ContentLength > 0)
                    BulletedList1.Items.Add(Server.HtmlEncode(hfc[h].FileName));
            }
            
        }
        else
        {
            Label1.Text = "You did not specify any files to upload or " +
                "the file(s) could not be found.";
        }

    }        
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpFileCollection Example</title>
</head>
<body>
    <form id="form1" 
          runat="server">
    <div>
        <asp:FileUpload ID="FileUpload1" 
                        runat="server" />
        <br />
        <asp:FileUpload ID="FileUpload2" 
                        runat="server" />
        <br />
        <asp:Button ID="Button1" 
                    runat="server" 
                    OnClick="Button1_Click" 
                    Text="Upload" />
        <br />
        <asp:Label ID="Label1" 
                   runat="server"/>
        <br />
        <asp:BulletedList ID="BulletedList1" 
                          runat="server">
        </asp:BulletedList>
        </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

        ' Clear the BulletedList.
        BulletedList1.Items.Clear()
        
        ' Check to see if at least one file was specified.
        If (FileUpload1.HasFile Or FileUpload2.HasFile) Then
            
            Label1.Text = "The file collection consists of:"
            
            ' Get the HttpFileCollection.
            Dim hfc As HttpFileCollection = Request.Files
            For Each h As String In hfc.AllKeys
                
                ' Add an item to the BulletedList if a file
                ' was specified for the corresponding control.
                If (hfc(h).ContentLength > 0) Then
                    BulletedList1.Items.Add(Server.HtmlEncode(hfc(h).FileName))
                End If
            Next
        Else
            
            Label1.Text = "You did not specify any files to upload or " & _
                "the file(s) could not be found."
            
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HttpFileCollection Example</title>
</head>
<body>
    <form id="form1" 
          runat="server">
    <div>
        <asp:FileUpload ID="FileUpload1" 
                        runat="server" />
        <br />
        <asp:FileUpload ID="FileUpload2" 
                        runat="server" />
        <br />
        <asp:Button ID="Button1" 
                    runat="server" 
                    OnClick="Button1_Click" 
                    Text="Upload" />
        <br />
        <asp:Label ID="Label1" 
                   runat="server"/>
        <br />
        <asp:BulletedList ID="BulletedList1" 
                          runat="server">
        </asp:BulletedList>
        </div>
    </form>
</body>
</html>

Remarques

Les clients encodent des fichiers et les transmettent dans le corps du contenu à l’aide d’un format MIME multipart avec un en-tête HTTP Content-Type de multipart/form-data. ASP.NET extrait le ou les fichiers encodés du corps du contenu en membres individuels d’un HttpFileCollection. Les méthodes et les propriétés de la HttpPostedFile classe fournissent un accès au contenu et aux propriétés de chaque fichier.

Propriétés

Nom	Description
AllKeys	Obtient un tableau de chaînes contenant les clés (noms) de tous les membres de la collection de fichiers.
Count	Obtient le nombre de paires clé/valeur contenues dans l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
IsReadOnly	Obtient ou définit une valeur indiquant si l’instance NameObjectCollectionBase est en lecture seule. (Hérité de NameObjectCollectionBase)
Item[Int32]	Obtient l’objet avec l’index numérique spécifié à partir de l’objet HttpFileCollection.
Item[String]	Obtient l’objet portant le nom spécifié de la collection de fichiers.
Keys	Obtient une NameObjectCollectionBase.KeysCollection instance qui contient toutes les clés de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)

Méthodes

Nom	Description
BaseAdd(String, Object)	Ajoute une entrée avec la clé et la valeur spécifiées dans l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseClear()	Supprime toutes les entrées de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGet(Int32)	Obtient la valeur de l’entrée à l’index spécifié de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGet(String)	Obtient la valeur de la première entrée avec la clé spécifiée de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGetAllKeys()	Retourne un String tableau qui contient toutes les clés de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGetAllValues()	Retourne un Object tableau qui contient toutes les valeurs de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGetAllValues(Type)	Retourne un tableau du type spécifié qui contient toutes les valeurs de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGetKey(Int32)	Obtient la clé de l’entrée à l’index spécifié de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseHasKeys()	Obtient une valeur indiquant si l’instance NameObjectCollectionBase contient des entrées dont les clés ne sont pas `null`. (Hérité de NameObjectCollectionBase)
BaseRemove(String)	Supprime les entrées avec la clé spécifiée de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseRemoveAt(Int32)	Supprime l’entrée à l’index spécifié de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseSet(Int32, Object)	Définit la valeur de l’entrée à l’index spécifié de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseSet(String, Object)	Définit la valeur de la première entrée avec la clé spécifiée dans l’instance NameObjectCollectionBase , si elle est trouvée ; sinon, ajoute une entrée avec la clé et la valeur spécifiées dans l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
CopyTo(Array, Int32)	Copie les membres de la collection de fichiers vers un Array début à l’index spécifié du tableau.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
Get(Int32)	Retourne l’objet HttpPostedFile avec l’index numérique spécifié de la collection de fichiers.
Get(String)	Retourne l’objet HttpPostedFile portant le nom spécifié de la collection de fichiers.
GetEnumerator()	Retourne un énumérateur qui itère dans le NameObjectCollectionBase. (Hérité de NameObjectCollectionBase)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetKey(Int32)	Retourne le nom du HttpFileCollection membre avec l’index numérique spécifié.
GetMultiple(String)	Retourne tous les fichiers qui correspondent au nom spécifié.
GetObjectData(SerializationInfo, StreamingContext)	Obsolète. Implémente l’interface ISerializable et retourne les données nécessaires pour sérialiser l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDeserialization(Object)	Implémente l’interface ISerializable et déclenche l’événement de désérialisation lorsque la désérialisation est terminée. (Hérité de NameObjectCollectionBase)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
ICollection.CopyTo(Array, Int32)	Copie l’intégralité NameObjectCollectionBase dans une dimension unidimensionnelle Arraycompatible, en commençant à l’index spécifié du tableau cible. (Hérité de NameObjectCollectionBase)
ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à l’objet NameObjectCollectionBase est synchronisé (thread safe). (Hérité de NameObjectCollectionBase)
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à l’objet NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)

Méthodes d’extension

Nom	Description
AsParallel(IEnumerable)	Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.
Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?