通过

RepeatLayout 枚举

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

指定列表控件项的布局。

public enum class RepeatLayout
public enum RepeatLayout
type RepeatLayout = 
Public Enum RepeatLayout
继承
Object
ValueType
Enum
RepeatLayout

字段

名称 值 说明
Flow 1

不以表结构显示项。 呈现的标记由 span 元素组成，并且各项由 br 元素分隔。
OrderedList 3

不以表结构显示项。 呈现的标记由包含 ol 元素的 li 元素组成。
从 ASP.NET 4 开始，此值是新增选项，并且仅对 CheckBoxList 和 RadioButtonList 控件有效。
Table 0

在表中显示项。
此选项会使控件呈现可能不符合辅助功能标准的 HTML。 有关详细信息，请参阅 Visual Studio 和 ASP.NET 中的辅助功能。
UnorderedList 2

不以表结构显示项。 呈现的标记由包含 ul 元素的 li 元素组成。
从 ASP.NET 4 开始，此字段是新增选项，并且仅对 CheckBoxList 和 RadioButtonList 控件有效。

示例

下面的示例演示了一个列表控件，该控件的布局由 Table 枚举值定义。


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
         dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
            dr[3] = "Image" + i.ToString() + ".jpg";
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
 
      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once, when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsList.DataSource = CreateDataSource();
            ItemsList.DataBind();
         }

      }
 
      void Button_Click(Object sender, EventArgs e) 
      {
 
         // Set the repeat direction based on the selected value of the
         // DirectionList DropDownList control.
         ItemsList.RepeatDirection = 
             (RepeatDirection)DirectionList.SelectedIndex;

         // Set the repeat layout based on the selected value of the
         // LayoutList DropDownList control.
         ItemsList.RepeatLayout = (RepeatLayout)LayoutList.SelectedIndex;

         // Set the number of columns to display based on the selected
         // value of the ColumnsList DropDownList control.
         ItemsList.RepeatColumns = ColumnsList.SelectedIndex;

         // Show or hide the gridlines based on the value of the
         // ShowBorderCheckBox property. Note that gridlines are displayed
         // only if the RepeatLayout property is set to Table.
         if ((ShowBorderCheckBox.Checked) 
             && (ItemsList.RepeatLayout == RepeatLayout.Table)) 
         {
            ItemsList.BorderWidth = Unit.Pixel(1);
            ItemsList.GridLines = GridLines.Both;
         }    
         else  
         {
            ItemsList.BorderWidth = Unit.Pixel(0);
            ItemsList.GridLines = GridLines.None;
         }
    
      }    
 
   </script>
 
<head runat="server">
    <title>DataList Example</title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="0"
           BorderWidth="0"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage"
                 AlternatingText='<%# DataBinder.Eval(Container.DataItem, "StringValue") %>'
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
      <hr />

      <table cellpadding="5">

         <tr>

            <th>

               Repeat direction:

            </th>

            <th>

               Repeat layout:

            </th>

            <th>

               Repeat columns:

            </th>

            <th>

               <asp:CheckBox id="ShowBorderCheckBox"
                    Text="Show border"
                    Checked="False" 
                    runat="server" />

            </th>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="DirectionList" 
                    runat="server">

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

               </asp:DropDownList>

            </td>

            <td>

               <asp:DropDownList id="LayoutList" 
                    runat="server">

                  <asp:ListItem Selected="True">Table</asp:ListItem>
                  <asp:ListItem>Flow</asp:ListItem>

               </asp:DropDownList>

            </td>

            <td>

               <asp:DropDownList id="ColumnsList" 
                    runat="server">

                  <asp:ListItem Selected="True">0</asp:ListItem>
                  <asp:ListItem>1</asp:ListItem>
                  <asp:ListItem>2</asp:ListItem>
                  <asp:ListItem>3</asp:ListItem>
                  <asp:ListItem>4</asp:ListItem>
                  <asp:ListItem>5</asp:ListItem>

               </asp:DropDownList>

            </td>

            <td>

                

            </td>


         </tr>

      </table>     
         
      <asp:LinkButton id="RefreshButton" 
           Text="Refresh DataList" 
           OnClick="Button_Click" 
           runat="server"/>
 
   </form>
 
</body>
</html>


<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      Function CreateDataSource() As ICollection 
      
         ' Create sample data for the DataList control.
         Dim dt As DataTable = New DataTable()
         dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
         dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
         dt.Columns.Add(New DataColumn("ImageValue", GetType(String)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 To 8 

            dr = dt.NewRow()
 
            dr(0) = i
            dr(1) = "Description for item " & i.ToString()
            dr(2) = 1.23 * (i + 1)
            dr(3) = "Image" & i.ToString() & ".jpg"
 
            dt.Rows.Add(dr)

         Next i
 
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function
 
      Sub Page_Load(sender As Object, e As EventArgs) 

         ' Load sample data only once, when the page is first loaded.
         If Not IsPostBack Then 
     
            ItemsList.DataSource = CreateDataSource()
            ItemsList.DataBind()
         
         End If

      End Sub
 
      Sub Button_Click(sender As Object, e As EventArgs) 
 
         ' Set the repeat direction based on the selected value of the
         ' DirectionList DropDownList control.
         ItemsList.RepeatDirection = _
             CType(DirectionList.SelectedIndex, RepeatDirection)

         ' Set the repeat layout based on the selected value of the
         ' LayoutList DropDownList control.
         ItemsList.RepeatLayout = CType(LayoutList.SelectedIndex, RepeatLayout)

         ' Set the number of columns to display based on the selected
         ' value of the ColumnsList DropDownList control.
         ItemsList.RepeatColumns = ColumnsList.SelectedIndex

         ' Show or hide the gridlines based on the value of the
         ' ShowBorderCheckBox. Note that gridlines are displayed
         ' only if the RepeatLayout property is set to Table.
         If ShowBorderCheckBox.Checked _
             And ItemsList.RepeatLayout = RepeatLayout.Table Then 

            ItemsList.BorderWidth = Unit.Pixel(1)
            ItemsList.GridLines = GridLines.Both
         
         Else  
    
            ItemsList.BorderWidth = Unit.Pixel(0)
            ItemsList.GridLines = GridLines.None
         
         End If
    
      End Sub    
 
   </script>
 
<head runat="server">
    <title>DataList Example</title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="0"
           BorderWidth="0"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage"
                 AlternatingText='<%# DataBinder.Eval(Container.DataItem, "StringValue") %>'
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
      <hr />

      <table cellpadding="5">

         <tr>

            <th>

               Repeat direction:

            </th>

            <th>

               Repeat layout:

            </th>

            <th>

               Repeat columns:

            </th>

            <th>

               <asp:CheckBox id="ShowBorderCheckBox"
                    Text="Show border"
                    Checked="False" 
                    runat="server" />

            </th>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="DirectionList" 
                    runat="server">

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

               </asp:DropDownList>

            </td>

            <td>

               <asp:DropDownList id="LayoutList" 
                    runat="server">

                  <asp:ListItem Selected="True">Table</asp:ListItem>
                  <asp:ListItem>Flow</asp:ListItem>

               </asp:DropDownList>

            </td>

            <td>

               <asp:DropDownList id="ColumnsList" 
                    runat="server">

                  <asp:ListItem Selected="True">0</asp:ListItem>
                  <asp:ListItem>1</asp:ListItem>
                  <asp:ListItem>2</asp:ListItem>
                  <asp:ListItem>3</asp:ListItem>
                  <asp:ListItem>4</asp:ListItem>
                  <asp:ListItem>5</asp:ListItem>

               </asp:DropDownList>

            </td>

            <td>

                

            </td>


         </tr>

      </table>     
         
      <asp:LinkButton id="RefreshButton" 
           Text="Refresh DataList" 
           OnClick="Button_Click" 
           runat="server"/>
 
   </form>
 
</body>
</html>

以下示例演示为 CheckBoxList 属性设置为 Flow的RepeatLayout控件呈现的标记。

<span id="ctl00_MainContent_CheckBoxList1">  
  <input id="ctl00_MainContent_CheckBoxList1_0" type="checkbox"   
    name="ctl00$MainContent$CheckBoxList1$0" value="Item 1" />  
  <label for="ctl00_MainContent_CheckBoxList1_0">Item 1</label>  
  <br />  
  <input id="ctl00_MainContent_CheckBoxList1_1" type="checkbox"  
    name="ctl00$MainContent$CheckBoxList1$1" value="Item 2"/>  
  <label for="ctl00_MainContent_CheckBoxList1_1">Item 2</label>  
  <br />  
  <input id="ctl00_MainContent_CheckBoxList1_2" type="checkbox"  
    name="ctl00$MainContent$CheckBoxList1$2" value="Item 2" />  
  <label for="ctl00_MainContent_CheckBoxList1_2">Item 2</label>  
</span>

以下示例演示为 CheckBoxList 属性设置为 OrderedList的RepeatLayout控件呈现的标记。

<ol id="ctl00_MainContent_CheckBoxList3">  
  <li>  
    <input id="ctl00_MainContent_CheckBoxList3_0" type="checkbox"  
      name="ctl00$MainContent$CheckBoxList3$0" value="Item 1" />  
    <label for="ctl00_MainContent_CheckBoxList3_0">Item 1</label>  
  </li>  
  <li>  
    <input id="ctl00_MainContent_CheckBoxList3_1" type="checkbox"  
      name="ctl00$MainContent$CheckBoxList3$1" value="Item 2" />  
    <label for="ctl00_MainContent_CheckBoxList3_1">Item 2</label>  
  </li>  
  <li>  
    <input id="ctl00_MainContent_CheckBoxList3_2" type="checkbox"  
      name="ctl00$MainContent$CheckBoxList3$2" value="Item 2" />  
    <label for="ctl00_MainContent_CheckBoxList3_2">Item 2</label>  
  </li>  
</ol>

以下示例演示为 CheckBoxList 属性设置为 Table的RepeatLayout控件呈现的标记。

<table id="ctl00_MainContent_CheckBoxList2">  
  <tr>  
    <td>  
      <input id="ctl00_MainContent_CheckBoxList2_0" type="checkbox"  
        name="ctl00$MainContent$CheckBoxList2$0" value="Item 1" />  
      <label for="ctl00_MainContent_CheckBoxList2_0">Item 1</label>  
    </td>  
  </tr>  
  <tr>  
    <td>  
      <input id="ctl00_MainContent_CheckBoxList2_1" type="checkbox"  
        name="ctl00$MainContent$CheckBoxList2$1" value="Item 2" />  
      <label for="ctl00_MainContent_CheckBoxList2_1">Item 2</label>  
    </td>  
  </tr>  
  <tr>  
    <td>  
      <input id="ctl00_MainContent_CheckBoxList2_2" type="checkbox"  
        name="ctl00$MainContent$CheckBoxList2$2" value="Item 3" />  
      <label for="ctl00_MainContent_CheckBoxList2_2">Item 3</label>  
    </td>  
  </tr>  
</table>

以下示例演示为 CheckBoxList 属性设置为 UnorderedList的RepeatLayout控件呈现的标记。

<ul id="ctl00_MainContent_CheckBoxList4">  
  <li>  
    <input id="ctl00_MainContent_CheckBoxList4_0" type="checkbox"  
      name="ctl00$MainContent$CheckBoxList4$0" value="Item 1" />  
    <label for="ctl00_MainContent_CheckBoxList4_0">Item 1</label>  
  </li>  
  <li>  
    <input id="ctl00_MainContent_CheckBoxList4_1" type="checkbox"  
      name="ctl00$MainContent$CheckBoxList4$1" value="Item 2" />  
    <label for="ctl00_MainContent_CheckBoxList4_1">Item 2</label>  
  </li>  
  <li>  
    <input id="ctl00_MainContent_CheckBoxList4_2" type="checkbox"  
      name="ctl00$MainContent$CheckBoxList4$2" value="Item 2" />  
    <label for="ctl00_MainContent_CheckBoxList4_2">Item 2</label>  
  </li>  
</ul>

注解

RepeatLayout枚举表示列表控件的不同布局选项。

适用于

另请参阅