HttpFileCollection Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia dostęp do plików przekazywanych przez klienta i organizuje 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

Dziedziczenie: Object

NameObjectCollectionBase
HttpFileCollection

Przykłady

W poniższym przykładzie pokazano, jak uzyskać dostęp do HttpFileCollection kolekcji zwróconej z Files właściwości HttpRequest obiektu. Kolekcja HttpFileCollection jest wypełniana przez dwie FileUpload kontrolki na stronie sieci Web. Elementy w kolekcji plików są wyświetlane w kontrolce BulletedList .

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

Uwagi

Klienci kodują pliki i przesyłają je w treści zawartości przy użyciu wieloczęściowego formatu MIME z nagłówkiem HTTP Content-Type .multipart/form-data ASP.NET wyodrębnia zakodowane pliki z treści zawartości do poszczególnych elementów członkowskich obiektu HttpFileCollection. Metody i właściwości HttpPostedFile klasy zapewniają dostęp do zawartości i właściwości każdego pliku.

Właściwości

AllKeys	Pobiera tablicę ciągów zawierającą klucze (nazwy) wszystkich elementów członkowskich w kolekcji plików.
Count	Pobiera liczbę par klucz/wartość zawartych w wystąpieniu NameObjectCollectionBase . (Odziedziczone po NameObjectCollectionBase)
IsReadOnly	Pobiera lub ustawia wartość wskazującą, czy NameObjectCollectionBase wystąpienie jest tylko do odczytu. (Odziedziczone po NameObjectCollectionBase)
Item[Int32]	Pobiera obiekt z określonym indeksem liczbowym z obiektu HttpFileCollection.
Item[String]	Pobiera obiekt o określonej nazwie z kolekcji plików.
Keys	NameObjectCollectionBase.KeysCollection Pobiera wystąpienie zawierające wszystkie klucze w wystąpieniuNameObjectCollectionBase. (Odziedziczone po NameObjectCollectionBase)

Metody

BaseAdd(String, Object)	Dodaje wpis z określonym kluczem i wartością NameObjectCollectionBase do wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseClear()	Usuwa wszystkie wpisy z NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseGet(Int32)	Pobiera wartość wpisu w określonym indeksie NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseGet(String)	Pobiera wartość pierwszego wpisu z określonym kluczem z NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseGetAllKeys()	Zwraca tablicę zawierającą String wszystkie klucze w wystąpieniu NameObjectCollectionBase . (Odziedziczone po NameObjectCollectionBase)
BaseGetAllValues()	Zwraca tablicę zawierającą Object wszystkie wartości w wystąpieniu NameObjectCollectionBase . (Odziedziczone po NameObjectCollectionBase)
BaseGetAllValues(Type)	Zwraca tablicę określonego typu, która zawiera wszystkie wartości w wystąpieniu NameObjectCollectionBase . (Odziedziczone po NameObjectCollectionBase)
BaseGetKey(Int32)	Pobiera klucz wpisu w określonym indeksie NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseHasKeys()	Pobiera wartość wskazującą, czy NameObjectCollectionBase wystąpienie zawiera wpisy, których klucze nie `null`są . (Odziedziczone po NameObjectCollectionBase)
BaseRemove(String)	Usuwa wpisy z określonym kluczem z NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseRemoveAt(Int32)	Usuwa wpis w określonym indeksie NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseSet(Int32, Object)	Ustawia wartość wpisu w określonym indeksie NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseSet(String, Object)	Ustawia wartość pierwszego wpisu z określonym kluczem w wystąpieniu NameObjectCollectionBase , jeśli zostanie znaleziony. W przeciwnym razie dodaje wpis z określonym kluczem i wartością NameObjectCollectionBase do wystąpienia. (Odziedziczone po NameObjectCollectionBase)
CopyTo(Array, Int32)	Kopiuje elementy członkowskie kolekcji plików na Array początek w określonym indeksie tablicy.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Get(Int32)	HttpPostedFile Zwraca obiekt z określonym indeksem liczbowym z kolekcji plików.
Get(String)	HttpPostedFile Zwraca obiekt o określonej nazwie z kolekcji plików.
GetEnumerator()	Zwraca moduł wyliczający, który iteruje przez element NameObjectCollectionBase. (Odziedziczone po NameObjectCollectionBase)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetKey(Int32)	Zwraca nazwę HttpFileCollection elementu członkowskiego z określonym indeksem liczbowym.
GetMultiple(String)	Zwraca wszystkie pliki zgodne z określoną nazwą.
GetObjectData(SerializationInfo, StreamingContext)	Implementuje ISerializable interfejs i zwraca dane potrzebne do serializacji NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDeserialization(Object)	Implementuje ISerializable interfejs i zgłasza zdarzenie deserializacji po zakończeniu deserializacji. (Odziedziczone po NameObjectCollectionBase)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)	Kopiuje całość NameObjectCollectionBase do zgodnego jednowymiarowego Arrayobiektu , zaczynając od określonego indeksu tablicy docelowej. (Odziedziczone po NameObjectCollectionBase)
ICollection.IsSynchronized	Pobiera wartość wskazującą, czy dostęp do NameObjectCollectionBase obiektu jest synchronizowany (bezpieczny wątek). (Odziedziczone po NameObjectCollectionBase)
ICollection.SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do NameObjectCollectionBase obiektu. (Odziedziczone po NameObjectCollectionBase)

Metody rozszerzania

Cast<TResult>(IEnumerable)	Rzutuje elementy elementu IEnumerable na określony typ.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable elementu na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje element IEnumerable na .IQueryable

Dotyczy