Freigeben über


HtmlForm-Klasse

Ermöglicht den programmgesteuerten Zugriff auf das HTML-<form>-Element auf dem Server.

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

Syntax

'Declaration
Public Class HtmlForm
    Inherits HtmlContainerControl
'Usage
Dim instance As HtmlForm
public class HtmlForm : HtmlContainerControl
public ref class HtmlForm : public HtmlContainerControl
public class HtmlForm extends HtmlContainerControl
public class HtmlForm extends HtmlContainerControl

Hinweise

Das HtmlForm-Steuerelement ist ein Container für Serversteuerelemente auf einer Web Forms-Seite. Alle Serversteuerelemente, die Postbacks an den Server ausführen, müssen zwischen dem Start- und dem Endtag eines HtmlForm-Steuerelements platziert werden.

Hinweis

In ASP.NET kann nur ein HtmlForm-Steuerelement auf einer Web Forms-Seite aktiv sein. Wenn eine Web Forms-Seite mehrere aktive HtmlForm-Steuerelemente enthält, löst die Common Language Runtime beim Abrufen der Seite eine System.Web.HttpException-Ausnahme aus. Sie können aber ein MultiView-Steuerelement verwenden, bei dem jedes View-Objekt ein HtmlForm-Steuerelement enthält, da immer nur ein View zurzeit aktiv ist.

Sie können das Verhalten des HtmlForm-Steuerelements steuern, indem Sie dessen Eigenschaften festlegen. Legen Sie die Enctype-Eigenschaft fest, um den Codierungstyp für die Daten des Formulars anzugeben. Die Methode (GET oder POST), durch die ein Browser dem Server Formulardaten zur Verarbeitung übermittelt, wird durch Festlegen der Method-Eigenschaft angegeben.

Warnung

In der Standardeinstellung ist die Method-Eigenschaft auf POST festgelegt. Sie können den Wert dieser Eigenschaft zwar in GET ändern, allerdings werden dadurch möglicherweise die integrierten Zustands- und Postbackdienste unterbrochen, die vom ASP.NET-Seitenframework bereitgestellt werden.

Sie können Steuerelemente konfigurieren, die die IButtonControl-Schnittstelle implementieren, um die Daten an eine andere Zielseite zu senden. Dies wird als seitenübergreifendes Senden bezeichnet. Weitere Informationen finden Sie unter Seitenübergreifendes Senden in ASP.NET-Webseiten.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlForm finden Sie unter HtmlForm-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: Suchen von Web Forms-Steuerelementen auf einer Seite durch Durchlaufen der Steuerelementauflistung 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: Suchen von Web Forms-Steuerelementen auf einer Seite durch Durchlaufen der Steuerelementauflistung 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: Suchen von Web Forms-Steuerelementen auf einer Seite durch Durchlaufen der Steuerelementauflistung 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 mit der HtmlForm-Klasse ein einfaches Formular erstellt wird.

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

<script runat="server">

  Protected Sub AddButton_Click(ByVal sender As Object, ByVal e As EventArgs)

    Dim Answer As Integer
    
    ' Calculate and display the result.
    Answer = Convert.ToInt32(Value1.Value) + Convert.ToInt32(Value2.Value)
    AnswerMessage.InnerHtml = Answer.ToString()

  End Sub

</script>

<html> 

<head>

  <title>HtmlForm Example</title>

</head>

<body>

   <form Method="Post"
         Enctype="application/x-www-form-urlencoded" 
         runat="server">

      <h3> HtmlForm Example </h3>




















































      <table>
         <tr>
            <td colspan="5">
               Enter integer values into the text boxes. <br>
               Click the Add button to add the two values. <br>
               Click the Reset button to reset the text boxes.
            </td>
         </tr>
         <tr>
            <td colspan="5">
               &nbsp;
            </td>
         </tr>
         <tr align="center">
            <td>
               <input ID="Value1"
                      Type="Text"
                      Size="2"
                      MaxLength="3"
                      Value="1"
                      runat="server"/>
            </td>
            <td>
               + 
            </td>
            <td>
               <input ID="Value2"
                      Type="Text"
                      Size="2"
                      MaxLength="3"
                      Value="1"
                      runat="server"/>
            </td>
            <td>
               =
            </td>
            <td>
               
               <span ID="AnswerMessage"
                     runat="server"/>
            </td>
         </tr>
         <tr>
            <td colspan="2">
               <asp:RequiredFieldValidator
                    ID="Value1RequiredValidator"
                    ControlToValidate="Value1"
                    ErrorMessage="Please enter a value.<br>"
                    Display="Dynamic"
                    runat="server"/>
               <asp:CompareValidator
                    ID="Value1MinCompareValidator"
                    ControlToValidate="Value1"
                    Operator="LessThan"
                    Type="Integer"
                    ValueToCompare="100"
                    ErrorMessage="Please enter an integer less than 100.<br>"
                    Display="Dynamic"
                    runat="server"/>
               <asp:CompareValidator
                    ID="Value1MaxCompareValidator"
                    ControlToValidate="Value1"
                    Operator="GreaterThan"
                    Type="Integer"
                    ValueToCompare="0"
                    ErrorMessage="Please enter an integer greater than 0.<br>"
                    Display="Dynamic"
                    runat="server"/>
            </td>
            <td colspan="2">
               <asp:RequiredFieldValidator
                    ID="Value2RequiredValidator"
                    ControlToValidate="Value2"
                    ErrorMessage="Please enter a value.<br>"
                    Display="Dynamic"
                    runat="server"/>
               <asp:CompareValidator
                    ID="Value2MinCompareValidator"
                    ControlToValidate="Value2"
                    Operator="LessThan"
                    Type="Integer"
                    ValueToCompare="100"
                    ErrorMessage="Please enter an integer less than 100.<br>"
                    Display="Dynamic"
                    runat="server"/>
               <asp:CompareValidator
                    ID="Value2MaxCompareValidator"
                    ControlToValidate="Value2"
                    Operator="GreaterThan"
                    Type="Integer"
                    ValueToCompare="0"
                    ErrorMessage="Please enter an integer greater than 0.<br>"
                    Display="Dynamic"
                    runat="server"/>
            </td>
            <td>
               &nbsp
 
            </td>
         </tr>
         <tr align="center">
            <td colspan="4">
               <input Type="Submit"
                      Name="AddButton"
                      Value="Add"
                      OnServerClick="AddButton_Click"
                      runat="server"/>
               &nbsp;&nbsp;&nbsp;
               <input Type="Reset"
                      Name="AddButton"
                      Value="Reset"
                      runat="server"/>
            </td>
            <td>
               &nbsp;
            </td>
         </tr>
      </table>


   </form>

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

<script runat="server">

  protected void AddButton_Click(Object sender, EventArgs e)
  {

    int Answer;

    // Calculate and display the result.
    Answer = Convert.ToInt32(Value1.Value) + Convert.ToInt32(Value2.Value);
    AnswerMessage.InnerHtml = Answer.ToString();

  }
     
</script>
<html> 

<head>

  <title>HtmlForm Example</title>

</head>

<body>

   <form Method="Post"
         Enctype="application/x-www-form-urlencoded" 
         runat="server" id="myform">

      <h3> HtmlForm Example </h3>




















































      <table>
         <tr>
            <td colspan="5">
               Enter integer values into the text boxes. <br>
               Click the Add button to add the two values. <br>
               Click the Reset button to reset the text boxes.
            </td>
         </tr>
         <tr>
            <td colspan="5">
               &nbsp;
            </td>
         </tr>
         <tr align="center">
            <td>
               <input ID="Value1"
                      Type="Text"
                      Size="2"
                      MaxLength="3"
                      Value="1"
                      runat="server"/>
            </td>
            <td>
               + 
            </td>
            <td>
               <input ID="Value2"
                      Type="Text"
                      Size="2"
                      MaxLength="3"
                      Value="1"
                      runat="server"/>
            </td>
            <td>
               =
            </td>
            <td>
               
               <span ID="AnswerMessage"
                     runat="server"/>
            </td>
         </tr>
         <tr>
            <td colspan="2">
               <asp:RequiredFieldValidator
                    ID="Value1RequiredValidator"
                    ControlToValidate="Value1"
                    ErrorMessage="Please enter a value.<br>"
                    Display="Dynamic"
                    runat="server"/>
               <asp:CompareValidator
                    ID="Value1MinCompareValidator"
                    ControlToValidate="Value1"
                    Operator="LessThan"
                    Type="Integer"
                    ValueToCompare="100"
                    ErrorMessage="Please enter an integer less than 100.<br>"
                    Display="Dynamic"
                    runat="server"/>
               <asp:CompareValidator
                    ID="Value1MaxCompareValidator"
                    ControlToValidate="Value1"
                    Operator="GreaterThan"
                    Type="Integer"
                    ValueToCompare="0"
                    ErrorMessage="Please enter an integer greater than 0.<br>"
                    Display="Dynamic"
                    runat="server"/>
            </td>
            <td colspan="2">
               <asp:RequiredFieldValidator
                    ID="Value2RequiredValidator"
                    ControlToValidate="Value2"
                    ErrorMessage="Please enter a value.<br>"
                    Display="Dynamic"
                    runat="server"/>
               <asp:CompareValidator
                    ID="Value2MinCompareValidator"
                    ControlToValidate="Value2"
                    Operator="LessThan"
                    Type="Integer"
                    ValueToCompare="100"
                    ErrorMessage="Please enter an integer less than 100.<br>"
                    Display="Dynamic"
                    runat="server"/>
               <asp:CompareValidator
                    ID="Value2MaxCompareValidator"
                    ControlToValidate="Value2"
                    Operator="GreaterThan"
                    Type="Integer"
                    ValueToCompare="0"
                    ErrorMessage="Please enter an integer greater than 0.<br>"
                    Display="Dynamic"
                    runat="server"/>
            </td>
            <td>
               &nbsp
 
            </td>
         </tr>
         <tr align="center">
            <td colspan="4">
               <input Type="Submit"
                      Name="AddButton"
                      Value="Add"
                      OnServerClick="AddButton_Click"
                      runat="server"/>
               &nbsp;&nbsp;&nbsp;
               <input Type="Reset"
                      Name="AddButton"
                      Value="Reset"
                      runat="server"/>
            </td>
            <td>
               &nbsp;
            </td>
         </tr>
      </table>


   </form>

</body>
</html>

.NET Framework-Sicherheit

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.HtmlControls.HtmlControl
       System.Web.UI.HtmlControls.HtmlContainerControl
        System.Web.UI.HtmlControls.HtmlForm

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

HtmlForm-Member
System.Web.UI.HtmlControls-Namespace
HtmlContainerControl-Klasse
Enctype
Method

Weitere Ressourcen

Deklarative Syntax des HtmlForm-Serversteuerelements
HTML-Serversteuerelemente
Seitenübergreifendes Senden in ASP.NET-Webseiten