This documentation is archived and is not being maintained.

CheckBoxList.RepeatDirection Property

Gets or sets a value that indicates whether the control displays vertically or horizontally.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public virtual RepeatDirection RepeatDirection { get; set; }
<asp:CheckBoxList RepeatDirection="RepeatDirection" />

Property Value

Type: System.Web.UI.WebControls.RepeatDirection
One of the RepeatDirection values. The default is Vertical.

ExceptionCondition
ArgumentOutOfRangeException

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

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

NoteNote

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 the RepeatColumns property is set to 3, the items in the CheckBoxList control are displayed in three columns, as in the following table.

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 first column is filled from top to bottom, then the next column, and so on until all items are rendered. For example, if the RepeatColumns property is set to 3, the items of the CheckBoxList control are displayed in rows of three items each, as in the following table.

1

2

3

4

5

6

7

8

9

TopicLocation
How to: Set Layout in a CheckBoxList Web Server ControlBuilding ASP .NET Web Applications
How to: Set Layout in a CheckBoxList Web Server ControlBuilding ASP .NET Web Applications

The following code example demonstrates how to set the RepeatDirection property to specify that the display direction is vertical.

NoteNote

The following code samples use the single-file code model and may not work correctly if copied directly into a code-behind file. Each code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Page Code Model.


<%@ 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>CheckBoxList Example</title>
<script language="C#" runat="server">

   void Check_Clicked(Object sender, EventArgs e) 
   {
      Message.Text = "Selected Item(s):<br /><br />";
      for (int i = 0; i < CheckBoxList1.Items.Count; i++)
      {
         if (CheckBoxList1.Items[i].Selected)
            Message.Text += CheckBoxList1.Items[i].Text + "<br />";
      }
   }

</script>

</head>
<body>

   <form id="form1" action="CheckBoxList.aspx" method="post" runat="server">

      <h3>CheckBoxList Example</h3>

      <asp:CheckBoxList id="CheckBoxList1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           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:CheckBoxList>

      <br /><br />

      <asp:label id="Message" 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 runat="server">
    <title> CheckBoxList RepeatDirection Example </title>
<script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {

         Message.Text = "Selected Item(s):<br /><br />";

         // Iterate through the Items collection of the CheckBoxList
         // control and display the selected items.
         for (int i=0; i<checkboxlist1.Items.Count; i++)
         {

            if (checkboxlist1.Items[i].Selected)
            {

               Message.Text += checkboxlist1.Items[i].Text + "<br />";

            }

         }

      }

      void Index_Change(Object sender, EventArgs e) 
      {

         // Set the direction that the items are rendered in the 
         // CheckBoxList control.
         checkboxlist1.RepeatDirection = (RepeatDirection)List.SelectedIndex;

      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> CheckBoxList RepeatDirection Example </h3>

      Select items from the CheckBoxList.

      <br /><br />

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           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:CheckBoxList>

      <br /><br />

      <asp:label id="Message" runat="server"/>

      <hr />

      Select the direction to render the CheckBoxList items.

      <table cellpadding="5">

         <tr>

            <td>

               RepeatDirection:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="List"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Index_Change"
                    runat="server">

                  <asp:ListItem>Horizontal</asp:ListItem>
                  <asp:ListItem Selected="True">Vertical</asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>

      </table>

   </form>

</body>

</html>



.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: