HttpFileCollection Klasse

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht den Zugriff auf Dateien, die von einem Client hochgeladen wurden, und deren Organisation.

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

Vererbung: Object

NameObjectCollectionBase
HttpFileCollection

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie auf die auflistung zugegriffen wird, die HttpFileCollection von der Files Eigenschaft des HttpRequest Objekts zurückgegeben wird. Die HttpFileCollection Auflistung wird von zwei FileUpload Steuerelementen auf der Webseite aufgefüllt. Elemente in der Dateisammlung werden in einem BulletedList Steuerelement angezeigt.

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

Hinweise

Clients codieren Dateien und übertragen sie im Inhaltstext mithilfe des mehrteiligen MIME-Formats mit einem HTTP-Header Content-Type von multipart/form-data. ASP.NET extrahiert die codierten Dateien aus dem Inhaltstext in einzelne Member einer .HttpFileCollection Methoden und Eigenschaften der HttpPostedFile Klasse bieten Zugriff auf die Inhalte und Eigenschaften jeder Datei.

Eigenschaften

AllKeys	Ruft ein Zeichenfolgenarray ab, das die Schlüssel (Namen) aller Member in der Dateiauflistung enthält.
Count	Ruft die Anzahl von Schlüssel-Wert-Paaren in der NameObjectCollectionBase-Instanz ab. (Geerbt von NameObjectCollectionBase)
IsReadOnly	Ruft einen Wert ab, der angibt, ob die NameObjectCollectionBase-Instanz schreibgeschützt ist, oder legt diesen fest. (Geerbt von NameObjectCollectionBase)
Item[Int32]	Ruft das Objekt mit dem angegebenen numerischen Index aus HttpFileCollection ab.
Item[String]	Ruft das Objekt mit dem angegebenen Namen aus der Dateiauflistung ab.
Keys	Ruft eine NameObjectCollectionBase.KeysCollection-Instanz ab, die alle Schlüssel in der NameObjectCollectionBase-Instanz enthält. (Geerbt von NameObjectCollectionBase)

Methoden

BaseAdd(String, Object)	Fügt einen Eintrag mit dem angegebenen Schlüssel und Wert der NameObjectCollectionBase-Instanz hinzu. (Geerbt von NameObjectCollectionBase)
BaseClear()	Entfernt alle Einträge aus der NameObjectCollectionBase-Instanz. (Geerbt von NameObjectCollectionBase)
BaseGet(Int32)	Ruft den Wert des Eintrags am angegebenen Index der NameObjectCollectionBase-Instanz ab. (Geerbt von NameObjectCollectionBase)
BaseGet(String)	Ruft den Wert des ersten Eintrags mit dem angegebenen Schlüssel aus der NameObjectCollectionBase-Instanz ab. (Geerbt von NameObjectCollectionBase)
BaseGetAllKeys()	Gibt ein String-Array zurück, das alle Schlüssel der NameObjectCollectionBase-Instanz enthält. (Geerbt von NameObjectCollectionBase)
BaseGetAllValues()	Gibt ein Object-Array zurück, das alle Werte der NameObjectCollectionBase-Instanz enthält. (Geerbt von NameObjectCollectionBase)
BaseGetAllValues(Type)	Gibt ein Array des angegebenen Typs zurück, das alle Werte der NameObjectCollectionBase-Instanz enthält. (Geerbt von NameObjectCollectionBase)
BaseGetKey(Int32)	Ruft den Schlüssel des Eintrags am angegebenen Index der NameObjectCollectionBase-Instanz ab. (Geerbt von NameObjectCollectionBase)
BaseHasKeys()	Ruft einen Wert ab, der angibt, ob die NameObjectCollectionBase-Instanz Einträge enthält, deren Schlüssel nicht `null` sind. (Geerbt von NameObjectCollectionBase)
BaseRemove(String)	Entfernt die Einträge mit dem angegebenen Schlüssel aus der NameObjectCollectionBase-Instanz. (Geerbt von NameObjectCollectionBase)
BaseRemoveAt(Int32)	Entfernt den Eintrag am angegebenen Index der NameObjectCollectionBase-Instanz. (Geerbt von NameObjectCollectionBase)
BaseSet(Int32, Object)	Legt den Wert des Eintrags am angegebenen Index der NameObjectCollectionBase-Instanz fest. (Geerbt von NameObjectCollectionBase)
BaseSet(String, Object)	Legt den Wert des ersten Eintrags mit dem angegebenen Schlüssel in der NameObjectCollectionBase-Instanz fest. Wenn der Schlüssel nicht vorhanden ist, wird der NameObjectCollectionBase-Instanz ein Eintrag mit dem angegebenen Wert und Schlüssel hinzugefügt. (Geerbt von NameObjectCollectionBase)
CopyTo(Array, Int32)	Kopiert Member der Dateiauflistung beginnend am angegebenen Index in ein Array.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Get(Int32)	Gibt das HttpPostedFile-Objekt mit dem angegebenen numerischen Index aus der Dateiauflistung zurück.
Get(String)	Gibt das HttpPostedFile-Objekt mit dem angegebenen Namen aus der Dateiauflistung zurück.
GetEnumerator()	Gibt einen Enumerator zurück, der die NameObjectCollectionBase durchläuft. (Geerbt von NameObjectCollectionBase)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetKey(Int32)	Gibt den Namen des HttpFileCollection-Members mit dem angegebenen numerischen Index zurück.
GetMultiple(String)	Gibt alle Dateien zurück, die mit dem angegebenen Namen übereinstimmen.
GetObjectData(SerializationInfo, StreamingContext)	Implementiert die ISerializable-Schnittstelle und gibt die zum Serialisieren der NameObjectCollectionBase-Instanz erforderlichen Daten zurück. (Geerbt von NameObjectCollectionBase)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDeserialization(Object)	Implementiert die ISerializable-Schnittstelle und löst das Deserialisierungsereignis aus, sobald die Deserialisierung abgeschlossen ist. (Geerbt von NameObjectCollectionBase)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Kopiert die gesamte NameObjectCollectionBase-Instanz in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays. (Geerbt von NameObjectCollectionBase)
ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf das NameObjectCollectionBase-Objekt synchronisiert (threadsicher) ist. (Geerbt von NameObjectCollectionBase)
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf das NameObjectCollectionBase-Objekt synchronisiert werden kann. (Geerbt von NameObjectCollectionBase)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für