HttpFileCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece acesso e organiza ficheiros carregados por um cliente.
public ref class HttpFileCollection sealed : System::Collections::Specialized::NameObjectCollectionBasepublic sealed class HttpFileCollection : System.Collections.Specialized.NameObjectCollectionBasetype HttpFileCollection = class
inherit NameObjectCollectionBasePublic NotInheritable Class HttpFileCollection
Inherits NameObjectCollectionBase- Herança
Exemplos
O exemplo seguinte demonstra como aceder à HttpFileCollection coleção devolvida pela Files propriedade do HttpRequest objeto. A HttpFileCollection coleção é composta por dois FileUpload controlos na página Web. Os itens na coleção de ficheiros são exibidos num BulletedList controlo.
<%@ 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>
Observações
Os clientes codificam ficheiros e transmitem-nos no corpo do conteúdo usando o formato MIME multipart com um cabeçalho HTTP Content-Type de multipart/form-data. ASP.NET extrai o(s) ficheiro(s) codificado(s) do corpo do conteúdo em membros individuais de um HttpFileCollection. Os métodos e propriedades da HttpPostedFile classe fornecem acesso ao conteúdo e propriedades de cada ficheiro.
Propriedades
| Name | Description |
|---|---|
| AllKeys |
Obtém um array de strings contendo as chaves (nomes) de todos os membros da coleção de ficheiros. |
| Count |
Obtém o número de pares chave/valor contidos na NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| IsReadOnly |
Recebe ou define um valor que indica se a NameObjectCollectionBase instância é apenas leitura. (Herdado de NameObjectCollectionBase) |
| Item[Int32] |
Obtém o objeto com o índice numérico especificado a partir do HttpFileCollection. |
| Item[String] |
Obtém o objeto com o nome especificado da coleção de ficheiros. |
| Keys |
Obtém uma NameObjectCollectionBase.KeysCollection instância que contém todas as chaves da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
Métodos
| Name | 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() |
Devolve um String array que contém todas as chaves da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseGetAllValues() |
Devolve um Object array que contém todos os valores da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseGetAllValues(Type) |
Devolve um array do tipo especificado que contém todos os valores da 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 |
| 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 valor especificados à NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| CopyTo(Array, Int32) |
Copia os membros da coleção de ficheiros para um Array início no índice especificado do array. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Get(Int32) |
Devolve o HttpPostedFile objeto com o índice numérico especificado da coleção de ficheiros. |
| Get(String) |
Devolve o HttpPostedFile objeto com o nome especificado da coleção de ficheiros. |
| GetEnumerator() |
Devolve um enumerador que itera através do NameObjectCollectionBase. (Herdado de NameObjectCollectionBase) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetKey(Int32) |
Devolve o nome do HttpFileCollection membro com o índice numérico especificado. |
| GetMultiple(String) |
Devolve todos os ficheiros que correspondem ao nome especificado. |
| GetObjectData(SerializationInfo, StreamingContext) |
Implementa a ISerializable interface e devolve 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 atual Object. (Herdado de Object) |
| OnDeserialization(Object) |
Implementa a ISerializable interface e levanta o evento de desserialização quando a desserialização está concluída. (Herdado de NameObjectCollectionBase) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Copia a totalidade NameObjectCollectionBase para uma unidimensional Arraycompatível , começando no índice especificado do array alvo. (Herdado de NameObjectCollectionBase) |
| ICollection.IsSynchronized |
Recebe um valor que indica se o acesso ao NameObjectCollectionBase objeto está 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 da Extensão
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Permite a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable para um IQueryable. |
| Cast<TResult>(IEnumerable) |
Conjura os elementos de an IEnumerable para o tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |