HttpFileCollection Osztály

Definíció

Névtér:: System.Web

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Hozzáférést biztosít az ügyfél által feltöltött fájlokhoz és rendszerezheti azokat.

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

Öröklődés: Object

NameObjectCollectionBase
HttpFileCollection

Példák

Az alábbi példa bemutatja, hogyan férhet hozzá az HttpFileCollection objektum tulajdonságából Files HttpRequest visszaadott gyűjteményhez. A HttpFileCollection gyűjteményt a weblap két FileUpload vezérlője tölti ki. A fájlgyűjtemény elemei egy BulletedList vezérlőben jelennek meg.

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

Megjegyzések

Az ügyfelek többrészes MIME formátumban kódolják és továbbítják a fájlokat a tartalomtörzsben a http-fejléccel Content-Typemultipart/form-data. ASP.NET kinyeri a kódolt fájlt a tartalomtörzsből egy HttpFileCollection egyes tagjaiba. Az osztály metódusai HttpPostedFile és tulajdonságai hozzáférést biztosítanak az egyes fájlok tartalmához és tulajdonságaihoz.

Tulajdonságok

Name	Description
AllKeys	Lekéri a fájlgyűjtemény összes tagjának kulcsait (nevét) tartalmazó sztringtömböt.
Count	Lekéri a példányban NameObjectCollectionBase található kulcs-/értékpárok számát. (Öröklődés forrása NameObjectCollectionBase)
IsReadOnly	Lekéri vagy beállít egy értéket, amely jelzi, hogy a NameObjectCollectionBase példány írásvédett-e. (Öröklődés forrása NameObjectCollectionBase)
Item[Int32]	Lekéri a megadott numerikus indexet tartalmazó objektumot a HttpFileCollection.
Item[String]	Lekéri a megadott nevű objektumot a fájlgyűjteményből.
Keys	NameObjectCollectionBase.KeysCollection Lekéri a példány összes kulcsát tartalmazó példánytNameObjectCollectionBase. (Öröklődés forrása NameObjectCollectionBase)

Metódusok

Name	Description
BaseAdd(String, Object)	Hozzáad egy bejegyzést a megadott kulccsal és értékkel a NameObjectCollectionBase példányhoz. (Öröklődés forrása NameObjectCollectionBase)
BaseClear()	Eltávolítja az összes bejegyzést a NameObjectCollectionBase példányból. (Öröklődés forrása NameObjectCollectionBase)
BaseGet(Int32)	Lekéri a bejegyzés értékét a példány megadott indexében NameObjectCollectionBase . (Öröklődés forrása NameObjectCollectionBase)
BaseGet(String)	Lekéri az első bejegyzés értékét a megadott kulccsal a NameObjectCollectionBase példányból. (Öröklődés forrása NameObjectCollectionBase)
BaseGetAllKeys()	Egy tömböt ad String vissza, amely tartalmazza a példány összes kulcsát NameObjectCollectionBase . (Öröklődés forrása NameObjectCollectionBase)
BaseGetAllValues()	Egy tömböt ad Object vissza, amely a példány összes értékét NameObjectCollectionBase tartalmazza. (Öröklődés forrása NameObjectCollectionBase)
BaseGetAllValues(Type)	A megadott típusú tömböt adja vissza, amely a példány összes értékét NameObjectCollectionBase tartalmazza. (Öröklődés forrása NameObjectCollectionBase)
BaseGetKey(Int32)	Lekéri a bejegyzés kulcsát a példány megadott indexében NameObjectCollectionBase . (Öröklődés forrása NameObjectCollectionBase)
BaseHasKeys()	Egy értéket kap, amely jelzi, hogy a NameObjectCollectionBase példány tartalmaz-e olyan bejegyzéseket, amelyek kulcsai nem `null`. (Öröklődés forrása NameObjectCollectionBase)
BaseRemove(String)	Eltávolítja a megadott kulccsal rendelkező bejegyzéseket a NameObjectCollectionBase példányból. (Öröklődés forrása NameObjectCollectionBase)
BaseRemoveAt(Int32)	Eltávolítja a bejegyzést a példány megadott indexéből NameObjectCollectionBase . (Öröklődés forrása NameObjectCollectionBase)
BaseSet(Int32, Object)	A bejegyzés értékét a példány megadott indexében állítja NameObjectCollectionBase be. (Öröklődés forrása NameObjectCollectionBase)
BaseSet(String, Object)	Beállítja az első bejegyzés értékét a példányban NameObjectCollectionBase megadott kulccsal, ha megtalálható; ellenkező esetben hozzáad egy bejegyzést a megadott kulccsal és értékkel a NameObjectCollectionBase példányhoz. (Öröklődés forrása NameObjectCollectionBase)
CopyTo(Array, Int32)	A fájlgyűjtemény tagjait a tömb megadott indexének egyik Array elejére másolja.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Get(Int32)	HttpPostedFile A megadott numerikus indexet tartalmazó objektumot adja vissza a fájlgyűjteményből.
Get(String)	HttpPostedFile A megadott névvel rendelkező objektumot adja vissza a fájlgyűjteményből.
GetEnumerator()	Egy enumerátort ad vissza, amely a NameObjectCollectionBase. (Öröklődés forrása NameObjectCollectionBase)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetKey(Int32)	A megadott numerikus indexet tartalmazó tag nevét HttpFileCollection adja vissza.
GetMultiple(String)	A megadott névnek megfelelő összes fájlt adja vissza.
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Implementálja az interfészt ISerializable , és visszaadja a példány szerializálásához NameObjectCollectionBase szükséges adatokat. (Öröklődés forrása NameObjectCollectionBase)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnDeserialization(Object)	Implementálja az ISerializable interfészt, és a deszerializálás befejezésekor aktiválja a deszerializálási eseményt. (Öröklődés forrása NameObjectCollectionBase)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
ICollection.CopyTo(Array, Int32)	A teljes NameObjectCollectionBase példányt egy kompatibilis egydimenziósra Arraymásolja a céltömb megadott indexétől kezdve. (Öröklődés forrása NameObjectCollectionBase)
ICollection.IsSynchronized	Lekérdez egy értéket, amely jelzi, hogy az NameObjectCollectionBase objektumhoz való hozzáférés szinkronizálva van-e (szálbiztos). (Öröklődés forrása NameObjectCollectionBase)
ICollection.SyncRoot	Lekéri az objektumhoz való hozzáférés NameObjectCollectionBase szinkronizálására használható objektumot. (Öröklődés forrása NameObjectCollectionBase)

Bővítő metódusok

Name	Description
AsParallel(IEnumerable)	Lehetővé teszi a lekérdezés párhuzamosítását.
AsQueryable(IEnumerable)	Átalakítja az egyiket IEnumerable IQueryable.
Cast<TResult>(IEnumerable)	Egy elem elemeit IEnumerable a megadott típusra veti.
OfType<TResult>(IEnumerable)	Egy adott típus alapján szűri IEnumerable egy adott elem elemeit.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?