HtmlInputCheckBox-Klasse

Artikel
08/20/2007

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

Freigeben über