HtmlInputHidden-Klasse

Artikel
08/20/2007

Ermöglicht den programmgesteuerten Zugriff auf das HTML-<input type=hidden>-Element auf dem Server.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Class HtmlInputHidden
    Inherits HtmlInputControl
    Implements IPostBackDataHandler
'Usage
Dim instance As HtmlInputHidden

public class HtmlInputHidden : HtmlInputControl, IPostBackDataHandler

public ref class HtmlInputHidden : public HtmlInputControl, IPostBackDataHandler

public class HtmlInputHidden extends HtmlInputControl implements IPostBackDataHandler

public class HtmlInputHidden extends HtmlInputControl implements IPostBackDataHandler

Hinweise

Mit dem HtmlInputHidden-Steuerelement können Sie Informationen einbetten, die in Benutzern in einem <form>-Element nicht angezeigt werden. Diese Informationen werden beim Postback der Webseite an den Server gesendet. Das HtmlInputHidden-Steuerelement stellt ein ServerChange-Ereignis bereit, das ausgelöst wird, wenn der Wert der Value-Eigenschaft zwischen Bereitstellungen auf dem Server geändert wird. Daher können Sie einen Ereignishandler erstellen, der immer dann einen benutzerdefinierten Satz von Anweisungen ausführt, wenn das Ereignis ausgelöst wird.

Hinweis

Das HtmlInputHidden-Steuerelement besitzt keine eingebaute Methode, um Daten an den Server zurückzusenden. Um den Wert des Steuerelements zurück an den Server zu senden, müssen Sie auf der Webseite ein anderes Steuerelement bereitstellen, das Übermittlungen an den Server unterstützt, z. B. ein HtmlButton-Steuerelement.

Hinweis

Im ASP.NET-Seitenframework wird dieses HTML-Feature zum automatischen Laden und Beibehalten des Ansichtszustands der Serversteuerelemente auf einer Webseite verwendet.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlInputHidden finden Sie unter HtmlInputHidden-Konstruktor.

Thema	Position
Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax	Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen	Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe eines HtmlInputHidden-Steuerelements zwischen Postbacks an den Server Informationen auf der Webseite speichern können.

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

<html>
<head>

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


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

</head>

<body>

   <form runat=server>

      <h3>HtmlInputHidden Sample</h3>

      <input id="HiddenValue" 
             type=hidden 
             value="Initial Value" 
             runat=server>

      Enter a string: 
 
      <input id="StringContents" 
             type=text 
             size=40 
             runat=server>

      <p>

      <input type=submit 
             value="Enter" 
             OnServerClick="SubmitBtn_Click" 
             runat=server>

      <p>

      <span id=Span1 runat=server>
         This label will display the previously entered string.
      </span>

   </form>

</body>
</html>

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

<html>
<head>

   <script language="C#" runat="server">

      void Page_Load(object sender, EventArgs e) 
      {

         if (Page.IsPostBack) 
         {
            Span1.InnerHtml="Hidden value: <b>" + HiddenValue.Value + "</b>";
         }
      }

      void SubmitBtn_Click(object sender, EventArgs e) 
      {
         HiddenValue.Value=StringContents.Value;
      }

   </script>

</head>

<body>

   <form runat=server>

      <h3>HtmlInputHidden Sample</h3>

      <input id="HiddenValue" 
             type=hidden 
             value="Initial Value" 
             runat=server>

      Enter a string: 
 
      <input id="StringContents" 
             type=text 
             size=40 
             runat=server>

      <p>

      <input type=submit 
             value="Enter" 
             OnServerClick="SubmitBtn_Click" 
             runat=server>

      <p>

      <span id=Span1 runat=server>
         This label will display the previously entered string.
      </span>

   </form>

</body>
</html>

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

<html>
<head>

   <script language="JSCRIPT" runat="server">
    function Page_Load(sender : Object, e : EventArgs){
        if(Page.IsPostBack)
            Span1.InnerHtml = "Hidden value: " + "<b>" + HiddenValue.Value + "</b>"
    }


    function SubmitBtn_Click(sender : Object, e : EventArgs){
        HiddenValue.Value = StringContents.Value
    }
 </script>

</head>

<body>

   <form runat=server>

      <h3>HtmlInputHidden Sample</h3>

      <input id="HiddenValue" 
             type=hidden 
             value="Initial Value" 
             runat=server>

      Enter a string: 
 
      <input id="StringContents" 
             type=text 
             size=40 
             runat=server>

      <p>

      <input type=submit 
             value="Enter" 
             OnServerClick="SubmitBtn_Click" 
             runat=server>

      <p>

      <span id=Span1 runat=server>
         This label will display the previously entered string.
      </span>

   </form>

</body>
</html>

.NET Framework-Sicherheit

AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal

Vererbungshierarchie

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

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlInputHidden-Member
System.Web.UI.HtmlControls-Namespace
HtmlInputControl-Klasse

Weitere Ressourcen

HTML-Serversteuerelemente

Freigeben über