HtmlInputHidden サーバー コントロールの宣言構文

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

<input type=hidden> へのマップを作成するサーバー側コントロールを作成します。

HTML 要素を使用すると、情報をフォームの非表示コントロールに格納できます。

<input 
    Type="Hidden"
    EnableViewState="False|True"
    Id="string"
    Visible="False|True"
    OnDataBinding="OnDataBinding event handler"
    OnDisposed="OnDisposed event handler"
    OnInit="OnInit event handler"
    OnLoad="OnLoad event handler"
    OnPreRender="OnPreRender event handler"
    OnServerChange="OnServerChange event handler"
    OnUnload="OnUnload event handler"
    runat="server"
    />

解説

<input type=hidden> HTML 要素をプログラムするには、HtmlInputHidden コントロールを使用します。 このコントロールはフォームの一部ですが、フォームには表示されません。 HTML では状態は永続的でないため、このコントロールは通常 HtmlInputButton コントロールおよび HtmlInputText コントロールと組み合わせて、サーバーへのポストの合間に情報を保存するために使用されます。

注意

このコントロールには、終了タグは必要ありません。

使用例

HtmlInputHidden コントロールを使用して複数の要求間でビューステート情報を保存する方法の例を示します。 <span> コントロールは、現在の要求の直前の Web 要求で隠しフィールドに保存されていたテキストを表示します。

以下に、2 つのイベント ハンドラーがあります。 最初のイベントは、ページがサーバーにポストバックされたときに発生します。 イベント ハンドラーは、前のポスト要求で隠しフィールドに保存されていたテキストを取得し、<span> コントロールで表示します。 2 番目のイベントは、submit ボタンがクリックされたときに発生します。 イベント ハンドラーは、テキスト ボックスの内容を取得し、Web ページの隠しフィールドに保存します。

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlInputHidden Control</title>

    <script runat="server">
      Sub Page_Load(Source As Object, e As EventArgs)
         If Page.IsPostBack Then
            Span1.InnerHtml = "Hidden value: <b>" + HiddenValue.Value + "</b>"
         End If
      End Sub

      Sub SubmitBtn_Click(Source As Object, e As EventArgs)
         HiddenValue.Value = StringContents.Value
      End Sub
    </script>

</head>
<body>
    <h3>HtmlInputHidden Sample</h3>
    <form id="Form1" runat="server">
        <input id="HiddenValue" 
               type="hidden" value="Initial Value" runat="server" />
        Enter a string: 
        <input id="StringContents" type="text" size="40" runat="server" />
        <br />
        <input id="Submit1" type="submit" value="Enter" 
               onserverclick="SubmitBtn_Click" runat="server" />
        <br />
        <span id="Span1" runat="server">
           This label will display the previously entered text.
        </span>
    </form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlInputHidden Control</title>

    <script runat="server">
       void Page_Load(object Source, EventArgs e) 
       {
          if (Page.IsPostBack) 
          {
             Span1.InnerHtml="Hidden value: <b>" + 
                             HiddenValue.Value + "</b>";
          }
       }
       void SubmitBtn_Click(object Source, EventArgs e) 
       {
          HiddenValue.Value=StringContents.Value;
       }
    </script>

</head>
<body>
    <h3>HtmlInputHidden Sample</h3>
    <form id="Form1" runat="server">
        <input id="HiddenValue" 
               type="hidden" value="Initial Value" runat="server" />
        Enter a string: 
        <input id="StringContents" type="text" size="40" runat="server" />
        <br />
        <input id="Submit1" type="submit" value="Enter" 
               onserverclick="SubmitBtn_Click" runat="server" />
        <br />
        <span id="Span1" runat="server">
           This label will display the previously entered text.
        </span>
    </form>
</body>
</html>

参照

Reference

HtmlInputHidden

その他の技術情報

HTML サーバー コントロール