HttpFileCollection Třída

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í vícedílného formátu MIME s hlavičkou multipart/form-dataHTTP Content-Type . ASP.NET extrahuje kódované soubory z těla obsahu do jednotlivých členů objektu HttpFileCollection. Metody a vlastnosti HttpPostedFile třídy poskytují přístup k obsahu a vlastnostem každého souboru.

Vlastnosti

Name	Description
AllKeys	Získá řetězcové pole obsahující klíče (názvy) všech členů v kolekci souborů.
Count	Získá počet párů klíč/hodnota obsažených NameObjectCollectionBase v 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	Získá NameObjectCollectionBase.KeysCollection instanci, která obsahuje všechny klíče v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)

Metody

Name	Description
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, které obsahuje všechny klíče v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)
BaseGetAllValues()	Object Vrátí pole, 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 na 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 je nalezena; 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čuje, zda je zadaný objekt roven 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)	Zastaralé. Implementuje ISerializable rozhraní a vrací data potřebná k serializaci NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnDeserialization(Object)	Implementuje ISerializable rozhraní a vyvolá deserializační událost 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í

Name	Description
ICollection.CopyTo(Array, Int32)	Zkopíruje celý NameObjectCollectionBase soubor 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í

Name	Description
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede IEnumerable na IQueryable.
Cast<TResult>(IEnumerable)	Přetypuje prvky IEnumerable na zadaný typ.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable na základě zadaného typu.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?