HttpFileCollection Třída

Reference

Definice

Obor názvů:: System.Web

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje přístup k souborům nahraným klientem a uspořádá je.

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

Dědičnost: Object

NameObjectCollectionBase
HttpFileCollection

Příklady

Následující příklad ukazuje, jak získat přístup k kolekci HttpFileCollection vrácené Files z vlastnosti objektu HttpRequest . Kolekce HttpFileCollection je naplněna dvěma FileUpload ovládacími prvky na webové stránce. Položky v kolekci souborů se zobrazují v ovládacím BulletedList prvku.

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

Poznámky

Klienti kódují soubory a přenášejí je v těle obsahu pomocí formátu MIME s více částmi MIME s hlavičkou multipart/form-dataHTTP Content-Type . ASP.NET extrahuje kódované soubory z těla obsahu do jednotlivých členů HttpFileCollectionsouboru . Metody a vlastnosti HttpPostedFile třídy poskytují přístup k obsahu a vlastnostem každého souboru.

Vlastnosti

AllKeys	Získá pole řetězců obsahující klíče (názvy) všech členů v kolekci souborů.
Count	Získá počet párů klíč/hodnota obsažených v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)
IsReadOnly	Získá nebo nastaví hodnotu určující, zda NameObjectCollectionBase instance je jen pro čtení. (Zděděno od NameObjectCollectionBase)
Item[Int32]	Získá objekt se zadaným číselným indexem z objektu HttpFileCollection.
Item[String]	Získá objekt se zadaným názvem z kolekce souborů.
Keys	NameObjectCollectionBase.KeysCollection Získá instanci, která obsahuje všechny klíče v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)

Metody

BaseAdd(String, Object)	Přidá položku se zadaným klíčem a hodnotou do NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseClear()	Odebere všechny položky z NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseGet(Int32)	Získá hodnotu položky v zadaném indexu NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseGet(String)	Získá hodnotu první položky se zadaným klíčem z NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseGetAllKeys()	String Vrátí pole obsahující všechny klíče v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)
BaseGetAllValues()	Vrátí matici Object , která obsahuje všechny hodnoty v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)
BaseGetAllValues(Type)	Vrátí pole zadaného typu, které obsahuje všechny hodnoty v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)
BaseGetKey(Int32)	Získá klíč položky v zadaném indexu NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseHasKeys()	Získá hodnotu určující, zda NameObjectCollectionBase instance obsahuje položky, jejichž klíče nejsou `null`. (Zděděno od NameObjectCollectionBase)
BaseRemove(String)	Odebere položky se zadaným klíčem z NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseRemoveAt(Int32)	Odebere položku v zadaném indexu NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseSet(Int32, Object)	Nastaví hodnotu položky v zadaném indexu NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseSet(String, Object)	Nastaví hodnotu první položky se zadaným klíčem v NameObjectCollectionBase instanci, pokud se najde. V opačném případě přidá položku se zadaným klíčem a hodnotou do NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
CopyTo(Array, Int32)	Zkopíruje členy kolekce souborů na Array začátek zadaného indexu pole.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Get(Int32)	HttpPostedFile Vrátí objekt se zadaným číselným indexem z kolekce souborů.
Get(String)	HttpPostedFile Vrátí objekt se zadaným názvem z kolekce souborů.
GetEnumerator()	Vrátí enumerátor, který iteruje přes NameObjectCollectionBase. (Zděděno od NameObjectCollectionBase)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetKey(Int32)	Vrátí název člena HttpFileCollection se zadaným číselným indexem.
GetMultiple(String)	Vrátí všechny soubory, které odpovídají zadanému názvu.
GetObjectData(SerializationInfo, StreamingContext)	Implementuje ISerializable rozhraní a vrátí data potřebná k serializaci NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OnDeserialization(Object)	Implementuje ISerializable rozhraní a vyvolá událost deserializace po dokončení deserializace. (Zděděno od NameObjectCollectionBase)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

ICollection.CopyTo(Array, Int32)	Zkopíruje celý NameObjectCollectionBase objekt do kompatibilního jednorozměrného Array, počínaje zadaným indexem cílového pole. (Zděděno od NameObjectCollectionBase)
ICollection.IsSynchronized	Získá hodnotu označující, zda je přístup k objektu NameObjectCollectionBase synchronizován (bezpečné vlákno). (Zděděno od NameObjectCollectionBase)
ICollection.SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k objektu NameObjectCollectionBase . (Zděděno od NameObjectCollectionBase)

Metody rozšíření

Cast<TResult>(IEnumerable)	Přetypuje prvky zadaného IEnumerable typu.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable založené na zadaném typu.
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede na IEnumerable IQueryable.

Platí pro