HttpFileCollection 类

参考

定义

命名空间:: System.Web

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

提供对由客户端上载的文件的访问权限，并组织这些文件。

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

继承: Object

NameObjectCollectionBase
HttpFileCollection

示例

下面的示例演示如何访问 HttpFileCollection 从 Files 对象属性返回的 HttpRequest 集合。集合 HttpFileCollection 由网页上的两个 FileUpload 控件填充。文件集合中的项显示在控件中 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>

注解

客户端使用包含 HTTP Content-Type 标头 multipart/form-data的多部分 MIME 格式在内容正文中编码文件并将其传输。 ASP.NET 将编码的文件从内容正文 () 提取到单个成员中HttpFileCollection。类的方法和属性 HttpPostedFile 提供对每个文件的内容和属性的访问权限。

属性

AllKeys	获取一个字符串数组，该数组包含文件集合中所有成员的键（名称）。
Count	获取包含在 NameObjectCollectionBase 实例中的键/值对的数目。 (继承自 NameObjectCollectionBase)
IsReadOnly	获取或设置一个值，通过该值指示 NameObjectCollectionBase 实例是否为只读的。 (继承自 NameObjectCollectionBase)
Item[Int32]	从 HttpFileCollection 中获取具有指定数字索引的对象。
Item[String]	从文件集合中获取具有指定名称的对象。
Keys	获取包含 NameObjectCollectionBase.KeysCollection 实例中所有键的 NameObjectCollectionBase 实例。 (继承自 NameObjectCollectionBase)

方法

BaseAdd(String, Object)	将具有指定键和值的项添加到 NameObjectCollectionBase 实例中。 (继承自 NameObjectCollectionBase)
BaseClear()	移除 NameObjectCollectionBase 实例中的所有项。 (继承自 NameObjectCollectionBase)
BaseGet(Int32)	获取 NameObjectCollectionBase 实例的指定索引处的项值。 (继承自 NameObjectCollectionBase)
BaseGet(String)	获取 NameObjectCollectionBase 实例中第一个具有指定键的项值。 (继承自 NameObjectCollectionBase)
BaseGetAllKeys()	返回 String 数组，该数组包含 NameObjectCollectionBase 实例中的所有键。 (继承自 NameObjectCollectionBase)
BaseGetAllValues()	返回 Object 数组，该数组包含 NameObjectCollectionBase 实例中的所有值。 (继承自 NameObjectCollectionBase)
BaseGetAllValues(Type)	返回指定类型的数组，该数组包含 NameObjectCollectionBase 实例中的所有值。 (继承自 NameObjectCollectionBase)
BaseGetKey(Int32)	获取 NameObjectCollectionBase 实例的指定索引处的项键。 (继承自 NameObjectCollectionBase)
BaseHasKeys()	获取一个值，通过该值指示 NameObjectCollectionBase 实例是否包含键不为 `null` 的项。 (继承自 NameObjectCollectionBase)
BaseRemove(String)	移除 NameObjectCollectionBase 实例中具有指定键的项。 (继承自 NameObjectCollectionBase)
BaseRemoveAt(Int32)	移除 NameObjectCollectionBase 实例的指定索引处的项。 (继承自 NameObjectCollectionBase)
BaseSet(Int32, Object)	设置 NameObjectCollectionBase 实例的指定索引处的项值。 (继承自 NameObjectCollectionBase)
BaseSet(String, Object)	为 NameObjectCollectionBase 实例中第一个具有指定键的项设置值（如果有这样的项）；否则将具有指定键和值的项添加到 NameObjectCollectionBase 实例中。 (继承自 NameObjectCollectionBase)
CopyTo(Array, Int32)	从指定的数组索引处开始，将文件集合的成员复制到 Array 中。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Get(Int32)	从文件集合中返回具有指定数字索引的 HttpPostedFile 对象。
Get(String)	从文件集合中返回具有指定名称的 HttpPostedFile 对象。
GetEnumerator()	返回循环访问 NameObjectCollectionBase 的枚举数。 (继承自 NameObjectCollectionBase)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetKey(Int32)	返回具有指定数字索引的 HttpFileCollection 成员名称。
GetMultiple(String)	返回与指定名称相匹配的所有文件。
GetObjectData(SerializationInfo, StreamingContext)	实现 ISerializable 接口，并返回序列化 NameObjectCollectionBase 实例所需的数据。 (继承自 NameObjectCollectionBase)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnDeserialization(Object)	实现 ISerializable 接口，并在完成反序列化之后引发反序列化事件。 (继承自 NameObjectCollectionBase)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.CopyTo(Array, Int32)	从目标数组的指定索引处开始将整个 NameObjectCollectionBase 复制到兼容的一维 Array。 (继承自 NameObjectCollectionBase)
ICollection.IsSynchronized	获取一个值，该值指示对 NameObjectCollectionBase 对象的访问是否同步（线程安全）。 (继承自 NameObjectCollectionBase)
ICollection.SyncRoot	获取一个对象，该对象可用于同步对 NameObjectCollectionBase 对象的访问。 (继承自 NameObjectCollectionBase)

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

适用于

HttpFileCollection 类

定义

示例

注解

属性

方法

显式接口实现

扩展方法

适用于

另请参阅

其他资源