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.
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">
</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>
 
</td>
</tr>
<tr align="center">
<td colspan="4">
<input Type="Submit"
Name="AddButton"
Value="Add"
OnServerClick="AddButton_Click"
runat="server"/>
<input Type="Reset"
Name="AddButton"
Value="Reset"
runat="server"/>
</td>
<td>
</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">
</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>
 
</td>
</tr>
<tr align="center">
<td colspan="4">
<input Type="Submit"
Name="AddButton"
Value="Add"
OnServerClick="AddButton_Click"
runat="server"/>
<input Type="Reset"
Name="AddButton"
Value="Reset"
runat="server"/>
</td>
<td>
</td>
</tr>
</table>
</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.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