Share via


Deklarative Syntax des HtmlInputHidden-Serversteuerelements

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Erstellt ein serverseitiges Steuerelement, das dem <input type=hidden>

-HTML-Element zugeordnet wird und mit dem Sie Informationen in einem nicht sichtbaren Steuerelement in einem Formular speichern können.

<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"
    />

Hinweise

Verwenden Sie das HtmlInputHidden-Steuerelement, um das <input type=hidden>-HTML-Element zu programmieren. Obwohl dieses Steuerelement Bestandteil eines Formulars ist, wird es nie auf dem Formular angezeigt. Da der Zustand in HTML nicht erhalten bleibt, wird dieses Steuerelement häufig in Verbindung mit dem HtmlInputButton-Steuerelement und dem HtmlInputText-Steuerelement verwendet, um Informationen zwischen den Übertragungen an den Server zu speichern.

Hinweis

Dieses Steuerelement erfordert kein Endtag.

Beispiel

Das folgende Beispiel veranschaulicht, wie mithilfe des HtmlInputHidden-Steuerelements Ansichtszustandsinformationen über Anforderungen hinweg gespeichert werden können. Das <span>-Steuerelement zeigt den in dem versteckten Feld gespeicherten Text aus der Webanforderung unmittelbar vor der aktuellen Anforderung an.

Es gibt zwei Ereignishandler. Das erste Ereignis tritt ein, wenn die Seite an den Server zurückgesendet wird. Der Ereignishandler zeigt den im versteckten Feld aus der vorherigen Sendeanforderung gespeicherten Text in einem <span>-Steuerelement an. Das zweite Ereignis wird durch Klicken auf die Schaltfläche submit ausgelöst. Der Ereignishandler nimmt den Inhalt des Textfelds und speichert ihn in dem verborgenen Feld auf der Webseite.

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

Siehe auch

Referenz

HtmlInputHidden

Weitere Ressourcen

HTML-Serversteuerelemente