HtmlInputCheckBox-Klasse
Ermöglicht den programmgesteuerten Zugriff auf das HTML-<input type= checkbox>-Element auf dem Server.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class HtmlInputCheckBox
Inherits HtmlInputControl
Implements IPostBackDataHandler
'Usage
Dim instance As HtmlInputCheckBox
public class HtmlInputCheckBox : HtmlInputControl, IPostBackDataHandler
public ref class HtmlInputCheckBox : public HtmlInputControl, IPostBackDataHandler
public class HtmlInputCheckBox extends HtmlInputControl implements IPostBackDataHandler
public class HtmlInputCheckBox extends HtmlInputControl implements IPostBackDataHandler
Hinweise
Verwenden Sie das HtmlInputCheckBox-Steuerelement, um dem Benutzer das Auswählen zwischen einem true-Zustand oder einem false-Zustand zu ermöglichen. Mit der Checked-Eigenschaft können Sie bestimmen, ob das Steuerelement ausgewählt ist. Das HtmlInputCheckBox-Steuerelement stellt ein ServerChange-Ereignis bereit, das ausgelöst wird, wenn der Wert der Checked-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
Beim Klicken auf das HtmlInputCheckBox-Steuerelement werden keine Daten an den Server zurückgesendet. Um den Zustand des Steuerelements zurück an den Server zu senden, müssen Sie auf der Webseite ein weiteres Steuerelement bereitstellen, das Übermittlungen an den Server unterstützt, z. B. ein HtmlButton-Steuerelement.
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlInputCheckBox finden Sie unter HtmlInputCheckBox-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 ein Satz einfacher Antworten an Benutzer veranschaulicht, die eine Auswahl aus einer Reihe von HtmlInputCheckBox-Steuerelementen treffen.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<script language="VB" runat=server>
Sub SubmitBtn_Click (Source As Object, ByVal E as EventArgs)
If (Basketball.Checked = true) Then
' You like basketball
End If
If (Football.Checked = true) Then
' You like football
End If
If (Soccer.Checked = true) Then
' You like soccer
End If
End Sub
</script>
<body>
<form method=post runat=server>
Enter Interests:
<input id="Basketball" checked type=checkbox runat=server> Basketball
<input id="Football" type=checkbox runat=server> Football
<input id="Soccer" type=checkbox runat="server"> Soccer
<input type=button value="Enter" OnServerClick="SubmitBtn_Click" runat=server>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<html >
<script language="C#" runat=server>
protected void SubmitBtn_Click(object sender, EventArgs e)
{
if (Basketball.Checked)
{
// You like basketball
}
if (Football.Checked)
{
// You like football
}
if (Soccer.Checked)
{
// You like soccer
}
}
</script>
<body>
<form id="Form1" method=post runat=server>
Enter Interests:
<input id="Basketball" checked type=checkbox runat=server> Basketball
<input id="Football" type=checkbox runat=server> Football
<input id="Soccer" type=checkbox runat="server"> Soccer
<input id="Button1" type=button value="Enter" OnServerClick="SubmitBtn_Click" runat=server>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<script language="JSCRIPT" runat=server>
function SubmitBtn_Click (source : Object, e : EventArgs){
if(Basketball.Checked == true){
// You like basketball
}
if(Football.Checked == true){
// You like football
}
if(Soccer.Checked == true){
// You like soccer
}
}
</script>
<body>
<form method=post runat=server>
Enter Interests:
<input id="Basketball" checked type=checkbox runat=server> Basketball
<input id="Football" type=checkbox runat=server> Football
<input id="Soccer" type=checkbox runat="server"> Soccer
<input type=button value="Enter" OnServerClick="SubmitBtn_Click" runat=server>
</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.HtmlInputCheckBox
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
HtmlInputCheckBox-Member
System.Web.UI.HtmlControls-Namespace
Weitere Ressourcen
Deklarative Syntax des HtmlInputCheckBox-Serversteuerelements
HTML-Serversteuerelemente