HtmlInputFile

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

HtmlInputFile イベント

パブリック イベント

	名前	説明
	DataBinding	サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。)
	Disposed	サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。)
	Init	サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。)
	Load	サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。)
	PreRender	Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。)
	Unload	サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。)

参照

関連項目

HtmlInputFile クラス
System.Web.UI.HtmlControls 名前空間
HttpPostedFile
HtmlInputFile.PostedFile プロパティ
HtmlInputControl クラス
HtmlForm.Enctype プロパティ

その他の技術情報

httpRuntime 要素 (ASP.NET 設定スキーマ)
processModel 要素 (ASP.NET 設定スキーマ)
HTML サーバー コントロール
マシン構成ファイル

HtmlInputFile クラス

サーバーの HTML <input type= file> 要素へのプログラムによるアクセスを許可します。

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

Visual Basic (宣言)

<ValidationPropertyAttribute("Value")> _
Public Class HtmlInputFile
    Inherits HtmlInputControl
    Implements IPostBackDataHandler

Visual Basic (使用法)

Dim instance As HtmlInputFile

C#

[ValidationPropertyAttribute("Value")] 
public class HtmlInputFile : HtmlInputControl,
 IPostBackDataHandler

C++

[ValidationPropertyAttribute(L"Value")] 
public ref class HtmlInputFile : public
 HtmlInputControl, IPostBackDataHandler

J#

/** @attribute ValidationPropertyAttribute("Value") */ 
public class HtmlInputFile extends HtmlInputControl
 implements IPostBackDataHandler

JScript

ValidationPropertyAttribute("Value") 
public class HtmlInputFile extends
 HtmlInputControl implements IPostBackDataHandler

解説

HtmlInputFile サーバー コントロールを使用して、ブラウザ クライアントからサーバーへのバイナリ ファイルまたはテキスト ファイルのアップロードを処理します。ファイルのアップロードは、Microsoft Internet Explorer Version 3.02 以降で機能します。

メモ
このコントロールは、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 コンストラクタのトピックを参照してください。

Topic	Location
方法 : ASP.NET 構文を使用して HTML サーバー コントロールを Web ページに追加する	ASP .NET Web アプリケーションの作成
方法 : HTML サーバー コントロール プロパティをプログラムで設定する	ASP .NET Web アプリケーションの作成

使用例

HtmlInputFile コントロールを使用して、単純なファイル アップロードを処理する方法を次のコード例に示します。この例を正常に動作させるには、コンピュータの C: ドライブに Temp というディレクトリを作成する必要があります。

Visual Basic

<%@ 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>

C#

<%@ 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>

JScript

<%@ 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 のセキュリティ

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

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.HtmlControls.HtmlControl
       System.Web.UI.HtmlControls.HtmlInputControl
        System.Web.UI.HtmlControls.HtmlInputFile

スレッド セーフ

この型の 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

参照

関連項目
HtmlInputFile メンバ
System.Web.UI.HtmlControls 名前空間
HttpPostedFile
PostedFile
HtmlInputControl クラス
HtmlForm.Enctype プロパティ
その他の技術情報
httpRuntime 要素 (ASP.NET 設定スキーマ)
processModel 要素 (ASP.NET 設定スキーマ)
HTML サーバー コントロール
マシン構成ファイル

HtmlInputFile コンストラクタ

HtmlInputFile クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New HtmlInputFile

C#

public HtmlInputFile ()

C++

public:
HtmlInputFile ()

J#

public HtmlInputFile ()

JScript

public function HtmlInputFile ()

解説

このコンストラクタを使用して、HtmlInputFile クラスの新しいインスタンスを作成し、初期化します。

HtmlInputFile のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
Type	"file" リテラル文字列。

使用例

HtmlInputFile クラスの新しいインスタンスを作成する方法を次のコード例に示します。この例を正常に動作させるには、コンピュータの C: ドライブに Temp というディレクトリを作成する必要があります。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>

<script runat="server">
 
  Sub Button1_Click(ByVal sender As
 Object, ByVal e As EventArgs)

    ' Get HtmlInputFile control from the Controls collection
    ' of the PlaceHolder control.
    Dim file As HtmlInputFile = _
       CType(Place.FindControl("File1"), HtmlInputFile)
 
    ' Make sure a file was submitted.
    If Text1.Value = "" Then
         
      Span1.InnerHtml = "Error: You must enter a file name."
      Return
          
    End If
 
    ' Save the file.
    If file.PostedFile.ContentLength > 0 Then

      Try
        
        file.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


  Sub Page_Load(ByVal sender As
 Object, ByVal e As EventArgs)

    ' Create a new HtmlInputFile control.
    Dim file As HtmlInputFile = New
 HtmlInputFile()
    file.ID = "File1"

    ' Add the control to the Controls collection of the
    ' PlaceHolder control.
    Place.Controls.Clear()
    Place.Controls.Add(file)

  End Sub
 
</script>

<html>
  <head>
    <title>HtmlInputFile Constructor Example</title>
  </head>

<body>
 
   <h3>HtmlInputFile Constructor Example</h3>
 
   <form enctype="multipart/form-data" 
         runat="server">
 
      Specify the file to upload:
      <asp:PlaceHolder id="Place"
                       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>

C#

<%@ Page Language="C#" AutoEventWireup="True" %>

<script runat="server">
  
  void Button1_Click(object sender, EventArgs e)
  {

    // Get the HtmlInputFile control from the Controls collection 
    // of the PlaceHolder control.
    HtmlInputFile file = (HtmlInputFile)Place.FindControl("File1");

    // Make sure a file was submitted.
    if (Text1.Value == "")
    {
      Span1.InnerHtml = "Error: You must enter a file name.";
      return;
    }

    // Save the file.
    if (file.PostedFile.ContentLength > 0)
    {
      try
      {
        
        file.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() + ".";
        
      }
    }
  }

  void Page_Load(object sender, EventArgs e)
  {

    // Create a new HtmlInputFile control.
    HtmlInputFile file = new HtmlInputFile();
    file.ID = "File1";

    // Add the control to the Controls collection of the
    // PlaceHolder control.
    Place.Controls.Clear();
    Place.Controls.Add(file);

  }
 
</script>

<html>
  <head>
    <title>HtmlInputFile Constructor Example</title>
  </head>

  <body>
 
   <h3>HtmlInputFile Constructor Example</h3>
 
   <form enctype="multipart/form-data" 
         runat="server">
 
      Specify the file to upload:
      <asp:PlaceHolder id="Place" 
                       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>

プラットフォーム

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

参照

関連項目
HtmlInputFile クラス
HtmlInputFile メンバ
System.Web.UI.HtmlControls 名前空間
その他の技術情報
HTML サーバー コントロール

HtmlInputFile プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Accept	ユーザーが選択できるファイルの種類を制限するために使用する、コンマ区切りの MIME エンコーディング リストを取得または設定します。
	AppRelativeTemplateSourceDirectory	このコントロールが含まれている Page オブジェクトまたは UserControl オブジェクトのアプリケーション相対の仮想ディレクトリを取得または設定します。 ( Control から継承されます。)
	Attributes	ASP.NET ページ内にある、サーバー コントロール タグで表現されるすべての属性名/値ペアのコレクションを取得します。 ( HtmlControl から継承されます。)
	BindingContainer	このコントロールのデータ バインディングを格納しているコントロールを取得します。 ( Control から継承されます。)
	ClientID	ASP.NET によって生成されたサーバー コントロール ID を取得します。 ( Control から継承されます。)
	Controls	UI 階層構造の指定されたサーバー コントロールの子コントロールを表す ControlCollection オブジェクトを取得します。 ( Control から継承されます。)
	Disabled	HTML サーバー コントロールが無効かどうかを示す値を、取得または設定します。 ( HtmlControl から継承されます。)
	EnableTheming	このコントロールにテーマを適用するかどうかを示す値を取得または設定します。 ( Control から継承されます。)
	EnableViewState	サーバー コントロールが、そのビューステートおよび格納している子コントロールのビューステートを、要求しているクライアントに永続化させるかどうかを示す値を取得または設定します。 ( Control から継承されます。)
	ID	サーバー コントロールに割り当てられたプログラム ID を取得または設定します。 ( Control から継承されます。)
	MaxLength	クライアントのコンピュータでアップロードするファイルのファイル パスの最大長を取得または設定します。
	Name	HtmlInputControl コントロールの一意の識別名を取得または設定します。 ( HtmlInputControl から継承されます。)
	NamingContainer	同じ Control.ID プロパティ値を持つ複数のサーバー コントロールを区別するための一意の名前空間を作成する、サーバー コントロールの名前付けコンテナへの参照を取得します。 ( Control から継承されます。)
	Page	サーバー コントロールを含んでいる Page インスタンスへの参照を取得します。 ( Control から継承されます。)
	Parent	ページ コントロールの階層構造における、サーバー コントロールの親コントロールへの参照を取得します。 ( Control から継承されます。)
	PostedFile	クライアントが指定したアップロード ファイルへのアクセスを取得します。
	Site	デザイン サーフェイスに現在のコントロールを表示するときに、このコントロールをホストするコンテナに関する情報を取得します。 ( Control から継承されます。)
	Size	ファイル パスが入力されるテキスト ボックスの幅を取得または設定します。
	SkinID	コントロールに適用するスキンを取得または設定します。 ( Control から継承されます。)
	Style	ASP.NET ファイル内で指定された HTML サーバー コントロールに適用されるすべてのカスケード スタイル シート (CSS: Cascading Style Sheet) プロパティのコレクションを取得します。 ( HtmlControl から継承されます。)
	TagName	runat=server の属性と値のペアを格納するタグの要素名を取得します。 ( HtmlControl から継承されます。)
	TemplateControl	このコントロールを格納しているテンプレートへの参照を取得または設定します。 ( Control から継承されます。)
	TemplateSourceDirectory	現在のサーバー コントロールを格納している Page または UserControl の仮想ディレクトリを取得します。 ( Control から継承されます。)
	Type	HtmlInputControl のタイプを取得します。 ( HtmlInputControl から継承されます。)
	UniqueID	階層構造で修飾されたサーバー コントロールの一意の ID を取得します。 ( Control から継承されます。)
	Value	オーバーライドされます。 クライアントのコンピュータ上のファイルの完全パスを取得します。
	Visible	サーバー コントロールを UI としてページに表示するかどうかを示す値を取得または設定します。 ( Control から継承されます。)

プロテクト プロパティ

	名前	説明
	Adapter	コントロール用のブラウザ固有のアダプタを取得します。 ( Control から継承されます。)
	ChildControlsCreated	サーバー コントロールの子コントロールが作成されたかどうかを示す値を取得します。 ( Control から継承されます。)
	ClientIDSeparator	ClientID プロパティで使用される区切り記号を表す文字値を取得します。 ( Control から継承されます。)
	Context	現在の Web 要求に対するサーバー コントロールに関連付けられている HttpContext オブジェクトを取得します。 ( Control から継承されます。)
	DesignMode	コントロールがデザイン サーフェイスで使用されているかどうかを示す値を取得します。 ( Control から継承されます。)
	Events	コントロールのイベント ハンドラ デリゲートのリストを取得します。このプロパティは読み取り専用です。 ( Control から継承されます。)
	HasChildViewState	現在のサーバー コントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。 ( Control から継承されます。)
	IdSeparator	コントロール ID を区別するために使用する文字を取得します。 ( Control から継承されます。)
	IsChildControlStateCleared	このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。 ( Control から継承されます。)
	IsTrackingViewState	サーバー コントロールがビューステートの変更を保存しているかどうかを示す値を取得します。 ( Control から継承されます。)
	IsViewStateEnabled	このコントロールでビューステートが有効かどうかを示す値を取得します。 ( Control から継承されます。)
	LoadViewStateByID	コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。 ( Control から継承されます。)
	ViewState	同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 ( Control から継承されます。)
	ViewStateIgnoresCase	HtmlControl ビューステートが大文字小文字を区別するかどうかを示す値を取得します。 ( HtmlControl から継承されます。)

参照

関連項目

HtmlInputFile クラス
System.Web.UI.HtmlControls 名前空間
HttpPostedFile
PostedFile
HtmlInputControl クラス
HtmlForm.Enctype プロパティ

その他の技術情報

httpRuntime 要素 (ASP.NET 設定スキーマ)
processModel 要素 (ASP.NET 設定スキーマ)
HTML サーバー コントロール
マシン構成ファイル

HtmlInputFile メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	ApplyStyleSheetSkin	ページのスタイル シートに定義されたスタイル プロパティをコントロールに適用します。 ( Control から継承されます。)
	DataBind	オーバーロードされます。 呼び出されたサーバー コントロールと、そのすべての子コントロールにデータ ソースを連結します。 ( Control から継承されます。)
	Dispose	サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。 ( Control から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	FindControl	オーバーロードされます。 指定したサーバー コントロールの現在の名前付けコンテナを検索します。 ( Control から継承されます。)
	Focus	コントロールに入力フォーカスを設定します。 ( Control から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	HasControls	サーバー コントロールに子コントロールが含まれているかどうかを確認します。 ( Control から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	RenderControl	オーバーロードされます。 サーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を格納します。 ( Control から継承されます。)
	ResolveClientUrl	ブラウザで使用できる URL を取得します。 ( Control から継承されます。)
	ResolveUrl	要求側クライアントで使用できる URL に変換します。 ( Control から継承されます。)
	SetRenderMethodDelegate	サーバー コントロールとその内容を親コントロールに表示するイベント ハンドラ デリゲートを割り当てます。 ( Control から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	AddedControl	子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。 ( Control から継承されます。)
	AddParsedSubObject	サーバー コントロールに、XML または HTML の要素が解析されたことを通知し、その要素をサーバー コントロールの ControlCollection オブジェクトに追加します。 ( Control から継承されます。)
	BuildProfileTree	ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。 ( Control から継承されます。)
	ClearChildControlState	サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。 ( Control から継承されます。)
	ClearChildState	サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。 ( Control から継承されます。)
	ClearChildViewState	サーバー コントロールのすべての子コントロールのビューステート情報を削除します。 ( Control から継承されます。)
	CreateChildControls	ASP.NET ページ フレームワークによって呼び出され、コンポジション ベースの実装を使用するサーバー コントロールに、ポスト バックまたは表示のための準備として、格納する子コントロールを作成するように通知します。 ( Control から継承されます。)
	CreateControlCollection	( HtmlControl から継承されます。)
	DataBind	オーバーロードされます。 呼び出されたサーバー コントロールと、そのすべての子コントロールにデータ ソースを連結します。 ( Control から継承されます。)
	DataBindChildren	データ ソースをサーバー コントロールの子コントロールにバインドします。 ( Control から継承されます。)
	EnsureChildControls	サーバー コントロールに子コントロールが含まれているかどうかを確認します。含まれていない場合、子コントロールを作成します。 ( Control から継承されます。)
	EnsureID	ID が割り当てられていないコントロールの ID を作成します。 ( Control から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	FindControl	オーバーロードされます。 指定したサーバー コントロールの現在の名前付けコンテナを検索します。 ( Control から継承されます。)
	GetAttribute	HtmlControl コントロールの名前付き属性の値を取得します。 ( HtmlControl から継承されます。)
	GetDesignModeState	コントロールのデザイン時データを取得します。 ( Control から継承されます。)
	HasEvents	コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。 ( Control から継承されます。)
	IsLiteralContent	サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。 ( Control から継承されます。)
	LoadControlState	SaveControlState メソッドによって保存された前回のページ要求からコントロールの状態情報を復元します。 ( Control から継承されます。)
	LoadPostData	HtmlInputFile コントロールのポストバック データを処理します。
	LoadViewState	SaveViewState メソッドによって保存された前回のページ要求からビューステート情報を復元します。 ( Control から継承されます。)
	MapPathSecure	仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。 ( Control から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnBubbleEvent	サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。 ( Control から継承されます。)
	OnDataBinding	DataBinding イベントを発生させます。 ( Control から継承されます。)
	OnInit	Init イベントを発生させます。 ( Control から継承されます。)
	OnLoad	Load イベントを発生させます。 ( Control から継承されます。)
	OnPreRender	オーバーライドされます。 HtmlInputFile コントロールの PreRender イベントを発生させます。
	OnUnload	Unload イベントを発生させます。 ( Control から継承されます。)
	OpenFile	ファイルの読み込みで使用される Stream を取得します。 ( Control から継承されます。)
	RaiseBubbleEvent	イベントのソースおよびその情報をコントロールの親に割り当てます。 ( Control から継承されます。)
	RaisePostDataChangedEvent	コントロールの状態が変更されたことを HtmlInputFile コントロールに通知します。
	RemovedControl	子コントロールが Control オブジェクトの Controls コレクションから削除された後に呼び出されます。 ( Control から継承されます。)
	Render	クライアントに表示する内容を指定された HtmlTextWriter オブジェクトに書き込みます。 ( HtmlControl から継承されます。)
	RenderAttributes	指定した HtmlTextWriter オブジェクトに、HtmlInputControl コントロールの属性をレンダリングします。 ( HtmlInputControl から継承されます。)
	RenderBeginTag	コントロールの HTML の開始タグを指定した HtmlTextWriter オブジェクトに表示します。 ( HtmlControl から継承されます。)
	RenderChildren	クライアントに表示される内容の書き込みを行う、指定された HtmlTextWriter オブジェクトに、サーバー コントロールの子を出力します。 ( Control から継承されます。)
	RenderControl	オーバーロードされます。 サーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を格納します。 ( Control から継承されます。)
	ResolveAdapter	指定したコントロールを表示するコントロール アダプタを取得します。 ( Control から継承されます。)
	SaveControlState	ページがサーバーにポスト バックされた時間以降に発生した、サーバー コントロールの状態の変更を保存します。 ( Control から継承されます。)
	SaveViewState	ページがサーバーにポスト バックされた時間以降に発生した、サーバー コントロールのビューステートの変更を保存します。 ( Control から継承されます。)
	SetAttribute	HtmlControl コントロールの名前付き属性の値を設定します。 ( HtmlControl から継承されます。)
	SetDesignModeState	コントロールのデザイン時データを設定します。 ( Control から継承されます。)
	TrackViewState	サーバー コントロールにビューステートの変更を追跡させ、サーバー コントロールの StateBag オブジェクトに変更を格納できるようにします。このオブジェクトは、Control.ViewState プロパティによってアクセスできます。 ( Control から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Web.UI.IPostBackDataHandler.LoadPostData	このメンバの説明については、IPostBackDataHandler.LoadPostData のトピックを参照してください。
	System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent	このメンバの説明については、IPostBackDataHandler.RaisePostDataChangedEvent のトピックを参照してください。

参照

関連項目

HtmlInputFile クラス
System.Web.UI.HtmlControls 名前空間
HttpPostedFile
PostedFile
HtmlInputControl クラス
HtmlForm.Enctype プロパティ

その他の技術情報

httpRuntime 要素 (ASP.NET 設定スキーマ)
processModel 要素 (ASP.NET 設定スキーマ)
HTML サーバー コントロール
マシン構成ファイル

HtmlInputFile メンバ

サーバーの HTML <input type= file> 要素へのプログラムによるアクセスを許可します。

HtmlInputFile データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	HtmlInputFile	HtmlInputFile クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Accept	ユーザーが選択できるファイルの種類を制限するために使用する、コンマ区切りの MIME エンコーディング リストを取得または設定します。
	AppRelativeTemplateSourceDirectory	このコントロールが含まれている Page オブジェクトまたは UserControl オブジェクトのアプリケーション相対の仮想ディレクトリを取得または設定します。(Control から継承されます。)
	Attributes	ASP.NET ページ内にある、サーバー コントロール タグで表現されるすべての属性名/値ペアのコレクションを取得します。(HtmlControl から継承されます。)
	BindingContainer	このコントロールのデータ バインディングを格納しているコントロールを取得します。(Control から継承されます。)
	ClientID	ASP.NET によって生成されたサーバー コントロール ID を取得します。(Control から継承されます。)
	Controls	UI 階層構造の指定されたサーバー コントロールの子コントロールを表す ControlCollection オブジェクトを取得します。(Control から継承されます。)
	Disabled	HTML サーバー コントロールが無効かどうかを示す値を、取得または設定します。(HtmlControl から継承されます。)
	EnableTheming	このコントロールにテーマを適用するかどうかを示す値を取得または設定します。(Control から継承されます。)
	EnableViewState	サーバー コントロールが、そのビューステートおよび格納している子コントロールのビューステートを、要求しているクライアントに永続化させるかどうかを示す値を取得または設定します。(Control から継承されます。)
	ID	サーバー コントロールに割り当てられたプログラム ID を取得または設定します。(Control から継承されます。)
	MaxLength	クライアントのコンピュータでアップロードするファイルのファイル パスの最大長を取得または設定します。
	Name	HtmlInputControl コントロールの一意の識別名を取得または設定します。(HtmlInputControl から継承されます。)
	NamingContainer	同じ Control.ID プロパティ値を持つ複数のサーバー コントロールを区別するための一意の名前空間を作成する、サーバー コントロールの名前付けコンテナへの参照を取得します。(Control から継承されます。)
	Page	サーバー コントロールを含んでいる Page インスタンスへの参照を取得します。(Control から継承されます。)
	Parent	ページ コントロールの階層構造における、サーバー コントロールの親コントロールへの参照を取得します。(Control から継承されます。)
	PostedFile	クライアントが指定したアップロード ファイルへのアクセスを取得します。
	Site	デザイン サーフェイスに現在のコントロールを表示するときに、このコントロールをホストするコンテナに関する情報を取得します。(Control から継承されます。)
	Size	ファイル パスが入力されるテキスト ボックスの幅を取得または設定します。
	SkinID	コントロールに適用するスキンを取得または設定します。(Control から継承されます。)
	Style	ASP.NET ファイル内で指定された HTML サーバー コントロールに適用されるすべてのカスケード スタイル シート (CSS: Cascading Style Sheet) プロパティのコレクションを取得します。(HtmlControl から継承されます。)
	TagName	runat=server の属性と値のペアを格納するタグの要素名を取得します。(HtmlControl から継承されます。)
	TemplateControl	このコントロールを格納しているテンプレートへの参照を取得または設定します。 (Control から継承されます。)
	TemplateSourceDirectory	現在のサーバー コントロールを格納している Page または UserControl の仮想ディレクトリを取得します。(Control から継承されます。)
	Type	HtmlInputControl のタイプを取得します。(HtmlInputControl から継承されます。)
	UniqueID	階層構造で修飾されたサーバー コントロールの一意の ID を取得します。(Control から継承されます。)
	Value	オーバーライドされます。 クライアントのコンピュータ上のファイルの完全パスを取得します。
	Visible	サーバー コントロールを UI としてページに表示するかどうかを示す値を取得または設定します。(Control から継承されます。)

プロテクト プロパティ

	名前	説明
	Adapter	コントロール用のブラウザ固有のアダプタを取得します。(Control から継承されます。)
	ChildControlsCreated	サーバー コントロールの子コントロールが作成されたかどうかを示す値を取得します。(Control から継承されます。)
	ClientIDSeparator	ClientID プロパティで使用される区切り記号を表す文字値を取得します。(Control から継承されます。)
	Context	現在の Web 要求に対するサーバー コントロールに関連付けられている HttpContext オブジェクトを取得します。(Control から継承されます。)
	DesignMode	コントロールがデザイン サーフェイスで使用されているかどうかを示す値を取得します。(Control から継承されます。)
	Events	コントロールのイベント ハンドラ デリゲートのリストを取得します。このプロパティは読み取り専用です。(Control から継承されます。)
	HasChildViewState	現在のサーバー コントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。(Control から継承されます。)
	IdSeparator	コントロール ID を区別するために使用する文字を取得します。(Control から継承されます。)
	IsChildControlStateCleared	このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。(Control から継承されます。)
	IsTrackingViewState	サーバー コントロールがビューステートの変更を保存しているかどうかを示す値を取得します。(Control から継承されます。)
	IsViewStateEnabled	このコントロールでビューステートが有効かどうかを示す値を取得します。(Control から継承されます。)
	LoadViewStateByID	コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。 (Control から継承されます。)
	ViewState	同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。(Control から継承されます。)
	ViewStateIgnoresCase	HtmlControl ビューステートが大文字小文字を区別するかどうかを示す値を取得します。(HtmlControl から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	ApplyStyleSheetSkin	ページのスタイル シートに定義されたスタイル プロパティをコントロールに適用します。 (Control から継承されます。)
	DataBind	オーバーロードされます。 呼び出されたサーバー コントロールと、そのすべての子コントロールにデータ ソースを連結します。 (Control から継承されます。)
	Dispose	サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。 (Control から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	FindControl	オーバーロードされます。 指定したサーバー コントロールの現在の名前付けコンテナを検索します。 (Control から継承されます。)
	Focus	コントロールに入力フォーカスを設定します。 (Control から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	HasControls	サーバー コントロールに子コントロールが含まれているかどうかを確認します。 (Control から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	RenderControl	オーバーロードされます。 サーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を格納します。 (Control から継承されます。)
	ResolveClientUrl	ブラウザで使用できる URL を取得します。 (Control から継承されます。)
	ResolveUrl	要求側クライアントで使用できる URL に変換します。 (Control から継承されます。)
	SetRenderMethodDelegate	サーバー コントロールとその内容を親コントロールに表示するイベント ハンドラ デリゲートを割り当てます。 (Control から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	AddedControl	子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。 (Control から継承されます。)
	AddParsedSubObject	サーバー コントロールに、XML または HTML の要素が解析されたことを通知し、その要素をサーバー コントロールの ControlCollection オブジェクトに追加します。 (Control から継承されます。)
	BuildProfileTree	ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。 (Control から継承されます。)
	ClearChildControlState	サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。 (Control から継承されます。)
	ClearChildState	サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。 (Control から継承されます。)
	ClearChildViewState	サーバー コントロールのすべての子コントロールのビューステート情報を削除します。 (Control から継承されます。)
	CreateChildControls	ASP.NET ページ フレームワークによって呼び出され、コンポジション ベースの実装を使用するサーバー コントロールに、ポスト バックまたは表示のための準備として、格納する子コントロールを作成するように通知します。 (Control から継承されます。)
	CreateControlCollection	( HtmlControl から継承されます。)
	DataBind	オーバーロードされます。 呼び出されたサーバー コントロールと、そのすべての子コントロールにデータ ソースを連結します。 (Control から継承されます。)
	DataBindChildren	データ ソースをサーバー コントロールの子コントロールにバインドします。 (Control から継承されます。)
	EnsureChildControls	サーバー コントロールに子コントロールが含まれているかどうかを確認します。含まれていない場合、子コントロールを作成します。 (Control から継承されます。)
	EnsureID	ID が割り当てられていないコントロールの ID を作成します。 (Control から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	FindControl	オーバーロードされます。 指定したサーバー コントロールの現在の名前付けコンテナを検索します。 (Control から継承されます。)
	GetAttribute	HtmlControl コントロールの名前付き属性の値を取得します。 (HtmlControl から継承されます。)
	GetDesignModeState	コントロールのデザイン時データを取得します。 (Control から継承されます。)
	HasEvents	コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。 (Control から継承されます。)
	IsLiteralContent	サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。 (Control から継承されます。)
	LoadControlState	SaveControlState メソッドによって保存された前回のページ要求からコントロールの状態情報を復元します。 (Control から継承されます。)
	LoadPostData	HtmlInputFile コントロールのポストバック データを処理します。
	LoadViewState	SaveViewState メソッドによって保存された前回のページ要求からビューステート情報を復元します。 (Control から継承されます。)
	MapPathSecure	仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。 (Control から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnBubbleEvent	サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。 (Control から継承されます。)
	OnDataBinding	DataBinding イベントを発生させます。 (Control から継承されます。)
	OnInit	Init イベントを発生させます。 (Control から継承されます。)
	OnLoad	Load イベントを発生させます。 (Control から継承されます。)
	OnPreRender	オーバーライドされます。 HtmlInputFile コントロールの PreRender イベントを発生させます。
	OnUnload	Unload イベントを発生させます。 (Control から継承されます。)
	OpenFile	ファイルの読み込みで使用される Stream を取得します。 (Control から継承されます。)
	RaiseBubbleEvent	イベントのソースおよびその情報をコントロールの親に割り当てます。 (Control から継承されます。)
	RaisePostDataChangedEvent	コントロールの状態が変更されたことを HtmlInputFile コントロールに通知します。
	RemovedControl	子コントロールが Control オブジェクトの Controls コレクションから削除された後に呼び出されます。 (Control から継承されます。)
	Render	クライアントに表示する内容を指定された HtmlTextWriter オブジェクトに書き込みます。 (HtmlControl から継承されます。)
	RenderAttributes	指定した HtmlTextWriter オブジェクトに、HtmlInputControl コントロールの属性をレンダリングします。 (HtmlInputControl から継承されます。)
	RenderBeginTag	コントロールの HTML の開始タグを指定した HtmlTextWriter オブジェクトに表示します。 (HtmlControl から継承されます。)
	RenderChildren	クライアントに表示される内容の書き込みを行う、指定された HtmlTextWriter オブジェクトに、サーバー コントロールの子を出力します。 (Control から継承されます。)
	RenderControl	オーバーロードされます。 サーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を格納します。 (Control から継承されます。)
	ResolveAdapter	指定したコントロールを表示するコントロール アダプタを取得します。 (Control から継承されます。)
	SaveControlState	ページがサーバーにポスト バックされた時間以降に発生した、サーバー コントロールの状態の変更を保存します。 (Control から継承されます。)
	SaveViewState	ページがサーバーにポスト バックされた時間以降に発生した、サーバー コントロールのビューステートの変更を保存します。 (Control から継承されます。)
	SetAttribute	HtmlControl コントロールの名前付き属性の値を設定します。 (HtmlControl から継承されます。)
	SetDesignModeState	コントロールのデザイン時データを設定します。 (Control から継承されます。)
	TrackViewState	サーバー コントロールにビューステートの変更を追跡させ、サーバー コントロールの StateBag オブジェクトに変更を格納できるようにします。このオブジェクトは、Control.ViewState プロパティによってアクセスできます。 (Control から継承されます。)

パブリック イベント

	名前	説明
	DataBinding	サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。)
	Disposed	サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。)
	Init	サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。)
	Load	サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。)
	PreRender	Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。)
	Unload	サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Web.UI.IPostBackDataHandler.LoadPostData	このメンバの説明については、IPostBackDataHandler.LoadPostData のトピックを参照してください。
	System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent	このメンバの説明については、IPostBackDataHandler.RaisePostDataChangedEvent のトピックを参照してください。

参照

関連項目

HtmlInputFile クラス
System.Web.UI.HtmlControls 名前空間
HttpPostedFile
PostedFile
HtmlInputControl クラス
HtmlForm.Enctype プロパティ

その他の技術情報

httpRuntime 要素 (ASP.NET 設定スキーマ)
processModel 要素 (ASP.NET 設定スキーマ)
HTML サーバー コントロール
マシン構成ファイル