CheckBoxList.RepeatLayout 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定一個值，指定列表將以元素 table 、 ul 元素、 ol 元素 span 或元素來渲染。
public:
virtual property System::Web::UI::WebControls::RepeatLayout RepeatLayout { System::Web::UI::WebControls::RepeatLayout get(); void set(System::Web::UI::WebControls::RepeatLayout value); };[System.ComponentModel.Bindable(true)]
public virtual System.Web.UI.WebControls.RepeatLayout RepeatLayout { get; set; }public virtual System.Web.UI.WebControls.RepeatLayout RepeatLayout { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.RepeatLayout : System.Web.UI.WebControls.RepeatLayout with get, setmember this.RepeatLayout : System.Web.UI.WebControls.RepeatLayout with get, setPublic Overridable Property RepeatLayout As RepeatLayout屬性值
一個值，指定清單是要用元素table、ul元素、olspan元素還是元素來渲染。 預設值為 Table。
- 屬性
例外狀況
指定的配置並非其中 RepeatLayout 的數值之一。
範例
以下程式碼範例示範如何使用該 RepeatLayout 屬性來改變控制項所呈現的 HTML CheckBoxList 。
Note
以下的程式碼範例採用單一檔案程式碼模型，若直接複製到程式碼背後檔案中，可能無法正常運作。 每個程式碼範例必須複製到一個帶有 .aspx 副檔名的空文字檔中。 欲了解更多關於網頁表單程式碼模型的資訊，請參見 ASP.NET 網頁表單頁面程式碼模型。
<%@ 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 RepeatLayout 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 layout (table or flow) of the CheckBoxList control.
checkboxlist1.RepeatLayout = (RepeatLayout)List.SelectedIndex;
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> CheckBoxList RepeatLayout 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 whether to display the CheckBoxList control in
table or flow layout.
<table cellpadding="5">
<tr>
<td>
RepeatLayout:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="List"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Change"
runat="server">
<asp:ListItem Selected="True">Table</asp:ListItem>
<asp:ListItem>Flow</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ 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 runat="server">
<title> CheckBoxList RepeatLayout Example </title>
<script runat="server">
Sub Check_Clicked(sender as Object, e As EventArgs)
Message.Text = "Selected Item(s):<br /><br />"
' Iterate through the Items collection of the CheckBoxList
' control and display the selected items.
Dim i As Integer
For i=0 To checkboxlist1.Items.Count - 1
If checkboxlist1.Items(i).Selected Then
Message.Text &= checkboxlist1.Items(i).Text & "<br />"
End If
Next
End Sub
Sub Index_Change(sender as Object, e As EventArgs)
' Set the layout (table or flow) of the CheckBoxList control.
checkboxlist1.RepeatLayout = CType(List.SelectedIndex, RepeatLayout)
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> CheckBoxList RepeatLayout 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 whether to display the CheckBoxList control in
table or flow layout.
<table cellpadding="5">
<tr>
<td>
RepeatLayout:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="List"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Change"
runat="server">
<asp:ListItem Selected="True">Table</asp:ListItem>
<asp:ListItem>Flow</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</form>
</body>
</html>
備註
有關可用選項的資訊，請參閱 RepeatLayout 列舉。
Note
ASP.NET 4 新增兩個選項： OrderedList 和 UnorderedList。
有些 RepeatLayout 設定不允許水平佈局。 如需詳細資訊，請參閱 RepeatLayout 列舉。
