Freigeben über


HtmlInputRadioButton.Checked-Eigenschaft

Ruft einen Wert ab, der angibt, ob das HtmlInputRadioButton-Steuerelement ausgewählt ist, oder legt diesen fest.

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

Syntax

'Declaration
Public Property Checked As Boolean
'Usage
Dim instance As HtmlInputRadioButton
Dim value As Boolean

value = instance.Checked

instance.Checked = value
public bool Checked { get; set; }
public:
property bool Checked {
    bool get ();
    void set (bool value);
}
/** @property */
public boolean get_Checked ()

/** @property */
public void set_Checked (boolean value)
public function get Checked () : boolean

public function set Checked (value : boolean)

Eigenschaftenwert

true, wenn das HtmlInputRadioButton-Steuerelement ausgewählt ist, andernfalls false.

Hinweise

Mit der Checked-Eigenschaft können Sie ermitteln, ob das HtmlInputRadioButton-Steuerelement ausgewählt ist. Bei einer Gruppe von HtmlInputRadioButton-Steuerelementen müssen die Steuerelemente durchlaufen werden, und für jedes Steuerelement muss die Checked-Eigenschaft einzeln überprüft werden. Sie können mithilfe dieser Eigenschaft auch programmgesteuert angeben, ob das Steuerelement ausgewählt ist.

Sie können HtmlInputRadioButton-Steuerelemente in Gruppen zusammenfassen, indem Sie für die Name-Eigenschaft jedes in die Gruppe aufzunehmenden Optionsfeld-Steuerelements einen gemeinsamen Wert angeben.

Hinweis

Wenn Sie HtmlInputRadioButton-Steuerelemente in einer Gruppe zusammenfassen, kann immer nur jeweils ein Optionsfeld der Gruppe ausgewählt werden. Die Checked-Eigenschaft des ausgewählten Steuerelements wird auf true festgelegt, während dieselbe Eigenschaft für alle anderen Optionsfelder der Gruppe auf false festgelegt wird.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der Checked-Eigenschaft bestimmt wird, welches Optionsfeld der Gruppe ausgewählt ist.

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

<html>
<head>

   <script language="VB" runat="server">

    Sub Button1_Click(sender As Object, e As EventArgs)
        
        If Radio1.Checked = True Then
            Span1.InnerHtml = "Option 1 is selected"
        Else
            If Radio2.Checked = True Then
                Span1.InnerHtml = "Option 2 is selected"
            Else
                If Radio3.Checked = True Then
                    Span1.InnerHtml = "Option 3 is selected"
                End If
            End If
        End If
    End Sub 'Button1_Click

   </script>

</head>
<body>

   <form runat=server>

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode" 
             runat="server"/>

      Option 1<br>

      <input type="radio" 
             id="Radio2" 
             name="Mode" 
             runat="server"/>
      
      Option 2<br>

      <input type="radio" 
             id="Radio3" 
             name="Mode" 
             runat="server"/>

      Option 3

      <p>
      <span id="Span1" runat="server" />

      <p>
      <input type="button" 
             id="Button1" 
             value="Enter" 
             OnServerClick="Button1_Click" 
             runat="server">

   </form>

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

<html>
<head>

   <script language="C#" runat="server">

      void Button1_Click(object sender, EventArgs e) 
      {

         if (Radio1.Checked == true)
            Span1.InnerHtml = "Option 1 is selected";
         else if (Radio2.Checked == true)
            Span1.InnerHtml = "Option 2 is selected";
         else if (Radio3.Checked == true)
            Span1.InnerHtml = "Option 3 is selected";
      }

   </script>

</head>
<body>

   <form runat=server>

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode" 
             runat="server"/>

      Option 1<br>

      <input type="radio" 
             id="Radio2" 
             name="Mode" 
             runat="server"/>
      
      Option 2<br>

      <input type="radio" 
             id="Radio3" 
             name="Mode" 
             runat="server"/>

      Option 3

      <p>
      <span id="Span1" runat="server" />

      <p>
      <input type="button" 
             id="Button1" 
             value="Enter" 
             OnServerClick="Button1_Click" 
             runat="server">

   </form>

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

<html>
<head>

   <script language="JSCRIPT" runat="server">

    function Button1_Click(sender : Object, e : EventArgs){
        
        if(Radio1.Checked)
            Span1.InnerHtml = "Option 1 is selected"
        else if(Radio2.Checked)
            Span1.InnerHtml = "Option 2 is selected"
        else if(Radio3.Checked)
            Span1.InnerHtml = "Option 3 is selected"
    }

   </script>

</head>
<body>

   <form runat=server>

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode" 
             runat="server"/>

      Option 1<br>

      <input type="radio" 
             id="Radio2" 
             name="Mode" 
             runat="server"/>
      
      Option 2<br>

      <input type="radio" 
             id="Radio3" 
             name="Mode" 
             runat="server"/>

      Option 3

      <p>
      <span id="Span1" runat="server" />

      <p>
      <input type="button" 
             id="Button1" 
             value="Enter" 
             OnServerClick="Button1_Click" 
             runat="server">

   </form>

</body>
</html>
   

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

HtmlInputRadioButton-Klasse
HtmlInputRadioButton-Member
System.Web.UI.HtmlControls-Namespace
Name

Weitere Ressourcen

HTML-Serversteuerelemente