Deklarative Syntax des HtmlInputRadioButton-Serversteuerelements

Artikel
05/27/2012

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Erstellt ein serverseitiges Steuerelement, das dem <input type=radio>-HTML-Element zugeordnet wird und das Erstellen eines Optionsfelds auf einer Webseite ermöglicht.

<input
    Type="Radio"
    EnableViewState="False|True"
    Id="string"
    Visible="False|True"
    OnDataBinding="OnDataBinding event handler"
    OnDisposed="OnDisposed event handler"
    OnInit="OnInit event handler"
    OnLoad="OnLoad event handler"
    OnPreRender="OnPreRender event handler"
    OnServerChange="OnServerChange event handler"
    OnUnload="OnUnload event handler"
    runat="server"
    />

Hinweise

Verwenden Sie das HtmlInputRadioButton-Steuerelement, um das <input type=radio>-HTML-Element zu programmieren. Sie können mehrere HtmlInputRadioButton-Steuerelemente zusammenfassen, indem Sie die Name-Eigenschaftaller <input type=radio>-Elemente in der Gruppe auf ein- und denselben Wert festlegen. Optionsschaltflächen innerhalb der gleichen Gruppe schließen sich gegenseitig aus, d. h. es kann immer nur eine Optionsschaltfläche in der Gruppe aktiviert sein.

Hinweis

Dieses Steuerelement erfordert kein Endtag.

Das HtmlRadioButton-Steuerelement führt kein automatisches Postback an den Server aus. Wenn Sie ein Postback an den Server wünschen, müssen Sie eines der Schaltflächensteuerelemente wie beispielsweise HtmlInputButton, HtmlInputImage oder HtmlButton verwenden. Sie können das HtmlRadioButton-Steuerelement programmieren, indem Sie einen Handler für das ServerChange-Ereignis schreiben.

Hinweis

Das ServerChange-Ereignis wird nur für Optionsfelder ausgelöst, die in einen überprüften Zustand übergehen.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie einen Ereignishandler für das ServerChange-Ereignis des HtmlRadioButton-Steuerelements erstellen. Der Ereignishandler ermittelt, welche Optionsschaltfläche aktiviert ist, und zeigt diese Auswahl in einer Meldung an.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
<title>HtmlInputRadioButton Control</title>

   <script runat="server">
      Sub Server_Change(Source As Object, e As EventArgs)
         If Radio1.Checked = True Then
            Span1.InnerHtml = "Radio1 is checked"
         Else
            If Radio2.Checked = True Then
               Span1.InnerHtml = "Radio2 is checked"
            Else
               If Radio3.Checked = True Then
                  Span1.InnerHtml = "Radio3 is checked"
               End If
            End If
         End If
      End Sub
   </script>

</head>
<body>
   <form id="Form1" runat="server">

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 1<br />
      <input type="radio" 
             id="Radio2" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 2<br />
      <input type="radio" 
             id="Radio3" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 3
      <br />
      <span id="Span1" runat="server" />
      <br />
      <input type="submit" id="Button1" 
             value="Enter" 
             runat="server" />
   </form>
</body>
</html>

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
<title>HtmlInputRadioButton Control</title>

   <script runat="server">
      void Server_Change(object Source, EventArgs e) 
      {
         if (Radio1.Checked == true)
            Span1.InnerHtml = "Radio1 is checked";
         else if (Radio2.Checked == true)
            Span1.InnerHtml = "Radio2 is checked";
         else if (Radio3.Checked == true)
            Span1.InnerHtml = "Radio3 is checked";
      }
   </script>

</head>
<body>
   <form id="Form1" runat="server">

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 1<br />
      <input type="radio" 
             id="Radio2" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 2<br />
      <input type="radio" 
             id="Radio3" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 3
      <br />
      <span id="Span1" runat="server" />
      <br />
      <input type="submit" id="Button1" 
             value="Enter" 
             runat="server" />
   </form>
</body>
</html>

Siehe auch

Referenz

HtmlInputRadioButton

System.Web.UI.HtmlControls

Weitere Ressourcen

HTML-Serversteuerelemente

Share via