HttpPostedFile クラス

.NET Framework クラス ライブラリ リファレンス

HttpPostedFile クラス

クライアントによってアップロードされた個別のファイルにアクセスできるようにします。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 HttpPostedFile

Visual Basic (使用法)

Dim instance As HttpPostedFile

C#

public sealed class HttpPostedFile

C++

public ref class HttpPostedFile sealed

J#

public final class HttpPostedFile

JScript

public final class HttpPostedFile

解説

HttpFileCollection クラスは、クライアントからファイル コレクションとしてアップロードされたすべてのファイルにアクセスできるようにします。HttpPostedFile クラスのプロパティとメソッドを使用すると、個別のファイルに関する情報を取得したり、ファイルの読み取りや保存を実行できます。

HtmlInputFile コントロールは、クライアントからファイルを選択およびアップロードするために使用できます。

ファイルは MIME multipart/form-data 形式でアップロードされます。既定では、フォーム フィールドやアップロードされたファイルを含めて、サイズが 256 KB を超えるすべての要求は、サーバーのメモリにではなくディスクにバッファされます。

要求の許容サイズの上限を指定するには、MaxRequestLength プロパティにアクセスするか、Machine.config ファイルまたは Web.config ファイルで httpRuntime 要素 (ASP.NET 設定スキーマ) 要素の maxRequestLength 属性を設定します。既定は 4 MB です。

ファイル アップロードを含めて、1 要求についてサーバー メモリにバッファされるデータ量を指定するには、RequestLengthDiskThreshold プロパティにアクセスするか、Machine.config ファイルまたは Web.config ファイルで httpRuntime 要素 (ASP.NET 設定スキーマ) 要素の requestLengthDiskThreshold 属性を設定します。

MaxRequestLength プロパティと RequestLengthDiskThreshold プロパティを調整することで、サーバーのパフォーマンスを微調整できます。また、MaxRequestLength を設定して、サーバーに対する大量のファイルのポストによるサービス拒否攻撃を防ぐことも検討してください。

アップロード ファイルをバッファするために割り当てられるサーバー リソースは、要求が終了すると破棄されます。ファイルの永続コピーを保存するには、SaveAs メソッドを使用します。

Topic	Location
方法 : FileUpload Web サーバー コントロールを使用してファイルをアップロードする	ASP .NET Web アプリケーションの作成

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。

継承階層

System.Object
  System.Web.HttpPostedFile

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
HttpPostedFile メンバ
System.Web 名前空間
HtmlInputFile
HttpFileCollection クラス
その他の技術情報
httpRuntime 要素 (ASP.NET 設定スキーマ)