HtmlButton-Klasse
Ermöglicht den programmgesteuerten Zugriff auf das HTML-Tag <button> auf dem Server.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class HtmlButton
Inherits HtmlContainerControl
Implements IPostBackEventHandler
'Usage
Dim instance As HtmlButton
public class HtmlButton : HtmlContainerControl, IPostBackEventHandler
public ref class HtmlButton : public HtmlContainerControl, IPostBackEventHandler
public class HtmlButton extends HtmlContainerControl implements IPostBackEventHandler
public class HtmlButton extends HtmlContainerControl implements IPostBackEventHandler
Hinweise
Mit dem <button>-Element können Webentwickler Formularschaltflächen der Benutzeroberfläche erstellen, die aus eingebetteten HTML-Elementen, einschließlich anderer Serversteuerelemente, zusammengesetzt werden können.
Hinweis
Das <button>-Element ist in der HTML 4.0-Spezifikation definiert und wird nur in Microsoft Internet Explorer, Version 4.0 oder höher, unterstützt. Für das Erstellen von Formularschaltflächen der Benutzeroberfläche in anderen Browsern empfiehlt sich die Verwendung der HtmlInputImage-Klasse.
Stellen Sie einen benutzerdefinierten Ereignishandler für das ServerClick-Ereignis bereit, damit bei einem Klick auf das HtmlButton-Steuerelement eine Reihe benutzerdefinierter Anweisungen ausgeführt wird.
Hinweis
Das HtmlButton-Steuerelement rendert auf dem Clientbrowser ECMAScript. Im Clientbrowser muss ECMAScript aktiviert sein, damit dieses Steuerelement ordnungsgemäß funktioniert. Weitere Informationen über Clientskripts finden Sie unter Clientskript in ASP.NET-Webseiten.
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlButton finden Sie unter HtmlButton-Konstruktor.
Warnung
Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die u. U. böswillige Clientskripts enthalten können. Überprüfen Sie alle von einem Client gesendeten Informationen auf ausführbare Skripts, SQL-Anweisungen oder anderen Code, bevor Sie sie in der Anwendung anzeigen. ASP.NET stellt ein Validierungsfeature für Eingabeanforderungen bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Serversteuerelemente für die Validierung werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit dem ServerClick-Ereignis der im Textfeld eingegebene Name angezeigt wird.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<script language="VB" runat=server>
Sub FancyBtn_Click(Source As Object, E as EventArgs)
Message.InnerHtml = "Your name is: " & Name.Value
End Sub
</script>
<body>
<form method=post runat=server>
<h3> Enter Name: <input id="Name" type=text size=40 runat=server>
</h3>
<button OnServerClick=" FancyBtn_Click" runat=server>
<b><I> I'm a fancy HTML 4.0 button </I> </b>
</button>
<h1>
<span id="Message" runat=server></span>
</h1>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<script language="C#" runat=server>
protected void FancyBtn_Click(object sender, EventArgs e)
{
Message.InnerHtml = "Your name is: " + Name.Value;
}
</script>
<body>
<form method=post runat=server>
<h3> Enter Name: <input id="Name" type=text size=40 runat=server>
</h3>
<button OnServerClick=" FancyBtn_Click" runat=server id="BUTTON1">
<b><I> I'm a fancy HTML 4.0 button </I> </b>
</button>
<h1>
<span id="Message" runat=server></span>
</h1>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<script language="jscript" runat=server>
function FancyBtn_Click(Source: Object, E: EventArgs){
Message.InnerHtml = "Your name is: " + Name.Value
}
</script>
<body>
<form method=post runat=server>
<h3> Enter Name: <input id="Name" type=text size=40 runat=server>
</h3>
<button OnServerClick=" FancyBtn_Click" runat=server>
<b><I> I'm a fancy HTML 4.0 button </I> </b>
</button>
<h1>
<span id="Message" runat=server></span>
</h1>
</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.HtmlButton
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
HtmlButton-Member
System.Web.UI.HtmlControls-Namespace
HtmlContainerControl
ServerClick
Weitere Ressourcen
Clientskript in ASP.NET-Webseiten
Deklarative Syntax des HtmlButton-Serversteuerelements
HTML-Serversteuerelemente