HtmlInputFile クラス
アセンブリ: System.Web (system.web.dll 内)
構文<ValidationPropertyAttribute("Value")> _ Public Class HtmlInputFile Inherits HtmlInputControl Implements IPostBackDataHandler
[ValidationPropertyAttribute("Value")]
public class HtmlInputFile : HtmlInputControl,
IPostBackDataHandler
[ValidationPropertyAttribute(L"Value")] public ref class HtmlInputFile : public HtmlInputControl, IPostBackDataHandler
解説HtmlInputFile サーバー コントロールを使用して、ブラウザ クライアントからサーバーへのバイナリ ファイルまたはテキスト ファイルのアップロードを処理します。ファイルのアップロードは、Microsoft Internet Explorer Version 3.02 以降で機能します。
.gif) メモ |
|---|
| このコントロールは、HtmlForm コントロールの Enctype プロパティを "multipart/form-data" に設定しないと正しく動作しません。 |
ファイルをアップロードするように指定するには、コントロールのテキスト ボックスにファイルへの完全パス ("C:\MyFiles\Test.txt" など) を入力します。[参照] ボタンをクリックし、[ファイルの選択] ダイアログ ボックスでそのファイルを検索して選択することもできます。
HtmlInputFile コントロールには、サーバーへのポストバックの手段は組み込まれていません。サーバーにファイルをアップロードするには、PostedFile プロパティに格納されている System.Web.HttpPostedFile オブジェクトの SaveAs メソッドを使用します。この操作は、通常は、クリックなどのイベント処理メソッドで実行されます。
| メモ |
|---|
| HttpPostedFile クラスの SaveAs メソッドを使用するときは、必ずルートされたパス ("C:\MyFiles\Test.txt" など) を指定します。SaveAs メソッドは、httpRuntime 要素 (ASP.NET 設定スキーマ) 構成セクションの requireRootedSaveAsPath 属性で指定できます。この属性の既定値は true です。この属性に false を設定し、パスを指定せずに SaveAs メソッドを使用すると、systemroot \system32\inetsrv ディレクトリへのファイルの配置が試行されます。既定では、このディレクトリは書き込み保護されているため、その場所にはファイルを保存できません。ファイルを格納するディレクトリに対する書き込みアクセス許可を、ASP.NET が使用するアカウントに付与します。 |
大きなファイルをアップロードしているときは、httpRuntime 要素 (ASP.NET 設定スキーマ) 要素の maxRequestLength 属性を使用して最大許容ファイル サイズを大きくします。ファイルが指定サイズ超えると、ブラウザで DNS エラーが発生します。また、大きなファイルのアップロード中、次のエラー メッセージが表示されることもあります。
"メモリ使用が 460 MB (使用可能 RAM の 60 パーセント) を超えたため、aspnet_wp.exe (PID: 1520) が繰り返されました。"
このエラー メッセージが表示されたら、Machine.config ファイルの processModel 要素 (ASP.NET 設定スキーマ) 要素の memoryLimit 属性の値を大きくします。
HtmlInputFile のインスタンスの初期プロパティ値の一覧については、HtmlInputFile コンストラクタのトピックを参照してください。
使用例HtmlInputFile コントロールを使用して、単純なファイル アップロードを処理する方法を次のコード例に示します。この例を正常に動作させるには、コンピュータの C: ドライブに Temp というディレクトリを作成する必要があります。
<%@ Page Language="VB" AutoEventWireup="True" %> <script runat="server"> Sub Button1_Click(ByVal Source As Object, ByVal e As EventArgs) If Text1.Value = "" Then Span1.InnerHtml = "Error: You must enter a file name." Return End If If File1.PostedFile.ContentLength > 0 Then Try File1.PostedFile.SaveAs(("c:\temp\" & Text1.Value)) Span1.InnerHtml = "File uploaded successfully to <b>c:\temp\" & _ Text1.Value & "</b> on the Web server." Catch exc As Exception Span1.InnerHtml = "Error saving file <b>c:\temp\" & _ Text1.Value & "</b><br>" & exc.ToString() & "." End Try End If End Sub </script> <html> <head> <title>HtmlInputFile Example</title> </head> <body> <h3>HtmlInputFile Example</h3> <form enctype="multipart/form-data" runat="server"> Select File to Upload: <input id="File1" type="file" runat="server"> <p> Save as file name (no path): <input id="Text1" type="text" runat="server"> </p> <p> <span id=Span1 style="font: 8pt verdana;" runat="server" /> </p> <p> <input type=button id="Button1" value="Upload" onserverclick="Button1_Click" runat="server"> </p> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <script runat="server"> void Button1_Click(object Source, EventArgs e) { if (Text1.Value == "") { Span1.InnerHtml = "Error: You must enter a file name."; return; } if (File1.PostedFile.ContentLength > 0) { try { File1.PostedFile.SaveAs("c:\\temp\\" + Text1.Value); Span1.InnerHtml = "File uploaded successfully to <b>c:\\temp\\" + Text1.Value + "</b> on the Web server."; } catch (Exception exc) { Span1.InnerHtml = "Error saving file <b>c:\\temp\\" + Text1.Value + "</b><br>" + exc.ToString() + "."; } } } </script> <html> <head> <title>HtmlInputFile Example</title> </head> <body> <h3>HtmlInputFile Example</h3> <form enctype="multipart/form-data" runat="server"> Select File to Upload: <input id="File1" type="file" runat="server"> <p> Save as file name (no path): <input id="Text1" type="text" runat="server"> </p> <p> <span id=Span1 style="font: 8pt verdana;" runat="server" /> </p> <p> <input type=button id="Button1" value="Upload" onserverclick="Button1_Click" runat="server"> </p> </form> </body> </html>
<%@ Page Language="JScript" AutoEventWireup="True" %> <script runat="server"> function Button1_Click(source : Object, e : EventArgs){ if(Text1.Value == ""){ Span1.InnerHtml = "Error: You must enter a file name." return } if(File1.PostedFile.ContentLength > 0){ try { File1.PostedFile.SaveAs(("c:\\temp\\" + Text1.Value)) Span1.InnerHtml = "File uploaded successfully to <b>c:\\temp\\" + Text1.Value + "</b> on the Web server." } catch(exc : Exception) { Span1.InnerHtml = "Error saving file <b>c:\\temp\\" + Text1.Value + "</b><br>" + exc.ToString() + "." } } } </script> <html> <head> <title>HtmlInputFile Example</title> </head> <body> <h3>HtmlInputFile Example</h3> <form enctype="multipart/form-data" runat="server"> Select File to Upload: <input id="File1" type="file" runat="server"> <p> Save as file name (no path): <input id="Text1" type="text" runat="server"> </p> <p> <span id=Span1 style="font: 8pt verdana;" runat="server" /> </p> <p> <input type=button id="Button1" value="Upload" onserverclick="Button1_Click" runat="server"> </p> </form> </body> </html>
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.HtmlControls.HtmlInputControl
System.Web.UI.HtmlControls.HtmlInputFile
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- HtmlInputFile クラスのページへのリンク
