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 、Web ページ上の 2 つの 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()	NameObjectCollectionBase インスタンス内のすべてのキーを格納する String 配列を返します。 (継承元 NameObjectCollectionBase)
BaseGetAllValues()	NameObjectCollectionBase インスタンス内のすべての値を格納する Object 配列を返します。 (継承元 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 全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。 (継承元 NameObjectCollectionBase)
ICollection.IsSynchronized	NameObjectCollectionBase オブジェクトへのアクセスが同期されている (スレッドセーフである) かどうかを示す値を取得します。 (継承元 NameObjectCollectionBase)
ICollection.SyncRoot	NameObjectCollectionBase オブジェクトへのアクセスを同期するために使用できるオブジェクトを取得します。 (継承元 NameObjectCollectionBase)

拡張メソッド

Cast<TResult>(IEnumerable)	IEnumerable の要素を、指定した型にキャストします。
OfType<TResult>(IEnumerable)	指定された型に基づいて IEnumerable の要素をフィルター処理します。
AsParallel(IEnumerable)	クエリの並列化を有効にします。
AsQueryable(IEnumerable)	IEnumerable を IQueryable に変換します。

適用対象

次の方法で共有