Edit

Share via

RadioButtonList.RepeatDirection Property

  • Reference

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Gets or sets the direction in which the radio buttons within the group are displayed.

public:
 virtual property System::Web::UI::WebControls::RepeatDirection RepeatDirection { System::Web::UI::WebControls::RepeatDirection get(); void set(System::Web::UI::WebControls::RepeatDirection value); };
[System.ComponentModel.Bindable(true)]
public virtual System.Web.UI.WebControls.RepeatDirection RepeatDirection { get; set; }
public virtual System.Web.UI.WebControls.RepeatDirection RepeatDirection { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.RepeatDirection : System.Web.UI.WebControls.RepeatDirection with get, set
member this.RepeatDirection : System.Web.UI.WebControls.RepeatDirection with get, set
Public Overridable Property RepeatDirection As RepeatDirection

Property Value

RepeatDirection

One of the RepeatDirection values. The default is Vertical.

Attributes
BindableAttribute

Exceptions

ArgumentOutOfRangeException

The display direction of the list is not one of the RepeatDirection values.

Examples

The following code example demonstrates how to use the RepeatDirection property to display the items of a RadioButtonList control in columns filled top to bottom, and then left to right.

<%@ Page Language="C#" AutoEventWireup="True" %>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>RadioButtonList.RepeatDirection Example</title>
</head>
<body>

<asp:RadioButtonList id="RadioButtonList1"
      RepeatLayout="Table"
      RepeatColumns = "2" 
      RepeatDirection="Vertical" 
      runat="server">
 
    <asp:ListItem>Item 1</asp:ListItem>
    <asp:ListItem>Item 2</asp:ListItem>
    <asp:ListItem>Item 3</asp:ListItem>
    <asp:ListItem>Item 4</asp:ListItem>
    <asp:ListItem>Item 5</asp:ListItem>
    <asp:ListItem>Item 6</asp:ListItem>
 
 </asp:RadioButtonList>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>RadioButtonList.RepeatDirection Example</title>
</head>
<body>

<asp:RadioButtonList id="RadioButtonList1"
      RepeatLayout="Table"
      RepeatColumns = "2" 
      RepeatDirection="Vertical" 
      runat="server">
 
    <asp:ListItem>Item 1</asp:ListItem>
    <asp:ListItem>Item 2</asp:ListItem>
    <asp:ListItem>Item 3</asp:ListItem>
    <asp:ListItem>Item 4</asp:ListItem>
    <asp:ListItem>Item 5</asp:ListItem>
    <asp:ListItem>Item 6</asp:ListItem>
 
 </asp:RadioButtonList>
</body>
</html>

Remarks

Use this property to specify the display direction of the RadioButtonList control.

Note

The number of columns that are displayed is always determined by the RepeatColumns property.

If this property is set to RepeatDirection.Vertical and if the RepeatLayout property is set to Table, the first column is filled from top to bottom, then the next column, and so on until all items are rendered. For example, if RepeatColumns is set to 3, the items of the RadioButtonList control are displayed in three columns. A nine-item list would appear as follows.
1 4 7
2 5 8
3 6 9

If this property is set to RepeatDirection.Horizontal and if the RepeatLayout property is set to Table, the items in the list are displayed in rows loaded left to right, then top to bottom, until all items are rendered. For example, if RepeatColumns is set to 3, the items of the RadioButtonList control are displayed in rows of three items. A nine-item list would appear as follows.
1 2 3
4 5 6
7 8 9

Applies to

See also