This documentation is archived and is not being maintained.

HtmlInputRadioButton.Value Property

Gets or sets the value associated with the HtmlInputRadioButton control.

[Visual Basic]
Overrides Public Property Value As String
[C#]
public override string Value {get; set;}
[C++]
public: __property String* get_Value();
public: __property void set_Value(String*);
[JScript]
public override function get Value() : String;
public override function set Value(String);

Property Value

The value associated with the HtmlInputRadioButton control.

Remarks

Use the Value property to specify or determine the value associated with the HtmlInputRadioButton control. The value can be any valid string that you want to associate with the control. This is useful when you have multiple radio buttons and need perform a calculation based on the selection. For example, you can have radio buttons that represent different shipping methods. You can store the shipping cost in the Value property. When the user selects the shipping method, the appropriate shipping amount can be determined from this property and added to the sales total.

Example

[Visual Basic, C#] The following example demonstrates how to use the Value property to associate a description with the HtmlInputRadioButton control.

[Visual Basic] 

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

<html>
<head>

   <script runat="server">

      Sub Server_Change(sender As Object , e As EventArgs) 
      
         If Radio1.Checked Then
            Span1.InnerHtml = "You selected " & _
                              Radio1.Value
         ElseIf Radio2.Checked Then
            Span1.InnerHtml = "You selected " & _
                              Radio2.Value
         ElseIf Radio3.Checked Then
            Span1.InnerHtml = "You selected " & _
                              Radio3.Value
         End If

      End Sub
         

   </script>

</head>

<body>

   <form runat="server">

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode"
             value="Radio Button 1"
             OnServerChange="Server_Change" 
             runat="server"/>
      Option 1
      <br>

      <input type="radio" 
             id="Radio2" 
             name="Mode"
             value="Radio Button 2"
             OnServerChange="Server_Change" 
             runat="server"/>
      Option 2
      <br>

      <input type="radio" 
             id="Radio3" 
             name="Mode"
             value="Radio Button 3"
             OnServerChange="Server_Change" 
             runat="server"/>
      Option 3

      <p>

      <input type="submit" 
             id="Button1" 
             value="Submit" 
             runat="server"/>

      <p>

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

   </form>

</body>
</html>

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

<html>
<head>

   <script runat="server">

      void Server_Change(object sender, EventArgs e) 
      {
         if (Radio1.Checked)
            Span1.InnerHtml = "You selected " +
                              Radio1.Value;
         else if (Radio2.Checked)
            Span1.InnerHtml = "You selected " +
                              Radio2.Value;
         else if (Radio3.Checked)
            Span1.InnerHtml = "You selected " +
                              Radio3.Value;
      }
         

   </script>

</head>

<body>

   <form runat="server">

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode"
             value="Radio Button 1"
             OnServerChange="Server_Change" 
             runat="server"/>
      Option 1
      <br>

      <input type="radio" 
             id="Radio2" 
             name="Mode"
             value="Radio Button 2"
             OnServerChange="Server_Change" 
             runat="server"/>
      Option 2
      <br>

      <input type="radio" 
             id="Radio3" 
             name="Mode"
             value="Radio Button 3"
             OnServerChange="Server_Change" 
             runat="server"/>
      Option 3

      <p>

      <input type="submit" 
             id="Button1" 
             value="Submit" 
             runat="server"/>

      <p>

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

   </form>

</body>
</html>

[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

HtmlInputRadioButton Class | HtmlInputRadioButton Members | System.Web.UI.HtmlControls Namespace

Show: