Compartilhar via

HttpFileCollection Classe

Definição

Namespace:
System.Web
Assembly:
System.Web.dll

Fornece acesso e organiza arquivos carregados por um cliente.

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
Herança
Object
NameObjectCollectionBase
HttpFileCollection

Exemplos

O exemplo a seguir demonstra como acessar a HttpFileCollection coleção retornada da Files propriedade do HttpRequest objeto. A HttpFileCollection coleção é preenchida por dois FileUpload controles na página da Web. Os itens na coleção de arquivos são exibidos em um BulletedList controle.

<%@ 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>

Comentários

Os clientes codificam arquivos e os transmitem no corpo do conteúdo usando o formato MIME de várias partes com um cabeçalho HTTP Content-Type de multipart/form-data. ASP.NET extrai os arquivos codificados do corpo do conteúdo para membros individuais de um HttpFileCollection. Métodos e propriedades da HttpPostedFile classe fornecem acesso ao conteúdo e às propriedades de cada arquivo.

Propriedades

Nome Description
AllKeys

Obtém uma matriz de cadeia de caracteres que contém as chaves (nomes) de todos os membros na coleção de arquivos.
Count

Obtém o número de pares chave/valor contidos na NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
IsReadOnly

Obtém ou define um valor que indica se a NameObjectCollectionBase instância é somente leitura.

(Herdado de NameObjectCollectionBase)
Item[Int32]

Obtém o objeto com o índice numérico especificado do HttpFileCollection.
Item[String]

Obtém o objeto com o nome especificado da coleção de arquivos.
Keys

Obtém uma NameObjectCollectionBase.KeysCollection instância que contém todas as chaves na NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)

Métodos

Nome Description
BaseAdd(String, Object)

Adiciona uma entrada com a chave e o valor especificados à NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseClear()

Remove todas as entradas da NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseGet(Int32)

Obtém o valor da entrada no índice especificado da NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseGet(String)

Obtém o valor da primeira entrada com a chave especificada da NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseGetAllKeys()

Retorna uma String matriz que contém todas as chaves na NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseGetAllValues()

Retorna uma Object matriz que contém todos os valores na NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseGetAllValues(Type)

Retorna uma matriz do tipo especificado que contém todos os valores na NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseGetKey(Int32)

Obtém a chave da entrada no índice especificado da NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseHasKeys()

Obtém um valor que indica se a NameObjectCollectionBase instância contém entradas cujas chaves não nullsão .

(Herdado de NameObjectCollectionBase)
BaseRemove(String)

Remove as entradas com a chave especificada da NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseRemoveAt(Int32)

Remove a entrada no índice especificado da NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseSet(Int32, Object)

Define o valor da entrada no índice especificado da NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
BaseSet(String, Object)

Define o valor da primeira entrada com a chave especificada na NameObjectCollectionBase instância, se encontrada; caso contrário, adiciona uma entrada com a chave e o valor especificados na NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
CopyTo(Array, Int32)

Copia os membros da coleção de arquivos para um Array início no índice especificado da matriz.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Get(Int32)

Retorna o HttpPostedFile objeto com o índice numérico especificado da coleção de arquivos.
Get(String)

Retorna o HttpPostedFile objeto com o nome especificado da coleção de arquivos.
GetEnumerator()

Retorna um enumerador que itera por meio do NameObjectCollectionBase.

(Herdado de NameObjectCollectionBase)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetKey(Int32)

Retorna o nome do HttpFileCollection membro com o índice numérico especificado.
GetMultiple(String)

Retorna todos os arquivos que correspondem ao nome especificado.
GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Implementa a ISerializable interface e retorna os dados necessários para serializar a NameObjectCollectionBase instância.

(Herdado de NameObjectCollectionBase)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
OnDeserialization(Object)

Implementa a ISerializable interface e gera o evento de desserialização quando a desserialização é concluída.

(Herdado de NameObjectCollectionBase)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

Nome Description
ICollection.CopyTo(Array, Int32)

Copia o todo NameObjectCollectionBase para um unidimensional Arraycompatível, começando no índice especificado da matriz de destino.

(Herdado de NameObjectCollectionBase)
ICollection.IsSynchronized

Obtém um valor que indica se o NameObjectCollectionBase acesso ao objeto é sincronizado (thread safe).

(Herdado de NameObjectCollectionBase)
ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao NameObjectCollectionBase objeto.

(Herdado de NameObjectCollectionBase)

Métodos de Extensão

Nome Description
AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.
Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.

Aplica-se a

Confira também