Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe HttpFileCollection

Fornece acesso a e organiza arquivos carregados por um cliente.

Namespace:  System.Web
Assembly:  System.Web (em System.Web.dll)

public sealed class HttpFileCollection : NameObjectCollectionBase

O tipo HttpFileCollection expõe os membros a seguir.

  NomeDescrição
Propriedade públicaAllKeysObtém uma matriz de cadeia de caracteres que contém as chaves (nomes) de todos os membros da coleção de arquivos.
Propriedade públicaCountObtém o número de pares chave/valor, contidas no NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Propriedade protegidaIsReadOnlyObtém ou define um valor indicando se a NameObjectCollectionBase instância é somente leitura. (Herdado de NameObjectCollectionBase.)
Propriedade públicaItem[Int32]Obtém o objeto com o índice numérico especificado da HttpFileCollection.
Propriedade públicaItem[String]Obtém o objeto com o nome especificado da coleção de arquivos.
Propriedade públicaKeysObtém um NameObjectCollectionBase.KeysCollection instância que contém todas as chaves de NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Início

  NomeDescrição
Método protegidoBaseAddAdiciona uma entrada com a chave especificada e o valor para o NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseClearRemove todas as entradas a partir de NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseGet(Int32)Obtém o valor da entrada no índice especificado da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseGet(String)Obtém o valor da primeira entrada com a chave especificada a partir do NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseGetAllKeysRetorna um String matriz que contém todas as chaves de NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseGetAllValues()Retorna um Object matriz que contém todos os valores de NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseGetAllValues(Type)Retorna uma matriz do tipo especificado que contém todos os valores de NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseGetKeyObtém a chave da entrada no índice especificado da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseHasKeysObtém um valor indicando se o NameObjectCollectionBase instância contém entradas cujas chaves não são null. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseRemoveRemove as entradas com a chave especificada a partir do NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseRemoveAtRemove a entrada no índice especificado da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseSet(Int32, Object)Define o valor da entrada no índice especificado da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método protegidoBaseSet(String, Object)Define o valor da primeira entrada com a chave especificada na NameObjectCollectionBase de instância, se encontrado; Caso contrário, adiciona uma entrada com a chave especificada e o valor para o NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método públicoCopyToCopia os membros da coleção de arquivos para um Array início no índice especificado da matriz.
Método públicoEquals(Object) Determina se o Object especificado é igual ao Object atual. (Herdado de Object.)
Método protegidoFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGet(Int32)Retorna o HttpPostedFile o objeto com o índice numérico especificado da coleção de arquivos.
Método públicoGet(String)Retorna o HttpPostedFile o objeto com o nome especificado da coleção de arquivos.
Método públicoGetEnumeratorRetorna um enumerador que itera por meio de NameObjectCollectionBase. (Herdado de NameObjectCollectionBase.)
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método públicoGetKeyRetorna o nome da HttpFileCollection membro com um índice numérico especificado.
Método públicoGetObjectDataImplementa o ISerializable interface e retorna os dados necessários para serializar o NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoOnDeserializationImplementa o ISerializable interface e dispara o evento de desserialização quando terminar a desserialização. (Herdado de NameObjectCollectionBase.)
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Início

  NomeDescrição
Implementação explícita da interfaceMétodo particularICollection.CopyToCopia todo o NameObjectCollectionBase para um compatível unidimensional Array, iniciando no índice especificado da matriz de destino. (Herdado de NameObjectCollectionBase.)
Implementação explícita da interfacePropriedade particularICollection.IsSynchronizedObtém um valor indicando se acessar para a NameObjectCollectionBase objeto for sincronizado (segmento seguro). (Herdado de NameObjectCollectionBase.)
Implementação explícita da interfacePropriedade particularICollection.SyncRootObtém um objeto que pode ser usado para sincronizar o acesso para o NameObjectCollectionBase objeto. (Herdado de NameObjectCollectionBase.)
Início

Codificar arquivos de clientes e transmiti-las no corpo de conteúdo usando o formato de várias partes MIME com um HTTP Content-Type cabeçalho de multipart/form-data. ASP.NET extrai os arquivos codificados de corpo de conteúdo em membros individuais de um HttpFileCollection. Métodos e propriedades de HttpPostedFile classe fornecer acesso ao conteúdo e propriedades de cada arquivo.

O exemplo a seguir demonstra como acessar o HttpFileCollection coleção retornada do Files propriedade da HttpRequest objeto. O HttpFileCollection coleção é preenchida por dois FileUpload controles na página da Web. Os itens na coleção de arquivo são exibidos em um BulletedList de 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>


.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft