CheckBoxList.RepeatDirection Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol ditampilkan secara vertikal atau horizontal.
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
Nilai Properti
Salah RepeatDirection satu nilai. Default adalah Vertical
.
- Atribut
Pengecualian
Arah tampilan daftar yang ditentukan bukan salah RepeatDirection satu nilai.
Contoh
Contoh kode berikut menunjukkan cara mengatur RepeatDirection properti untuk menentukan bahwa arah tampilan vertikal.
Catatan
Sampel kode berikut menggunakan model kode file tunggal dan mungkin tidak berfungsi dengan benar jika disalin langsung ke file code-behind. Setiap sampel kode harus disalin ke dalam file teks kosong yang memiliki ekstensi .aspx. Untuk informasi selengkapnya tentang model kode Formulir Web, lihat Model Kode Halaman Formulir Web 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>
<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="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>
<title>CheckBoxList Example</title>
<script language="VB" runat="server">
Sub Check_Clicked(sender As Object, e As EventArgs)
Dim i As Integer
Message.Text = "Selected Item(s):<br /><br />"
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
</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>
<%@ 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 RepeatDirection 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 direction that the items are rendered in the
' CheckBoxList control.
checkboxlist1.RepeatDirection = _
CType(List.SelectedIndex, RepeatDirection)
End Sub
</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>
Keterangan
Gunakan properti ini untuk menentukan arah CheckBoxList tampilan kontrol.
Catatan
Jumlah kolom yang ditampilkan selalu ditentukan oleh RepeatColumns properti .
Jika properti ini diatur ke RepeatDirection.Vertical
dan jika RepeatLayout properti diatur ke Table, kolom pertama diisi dari atas ke bawah, maka kolom berikutnya, dan sebagainya hingga semua item dirender. Misalnya, jika RepeatColumns properti diatur ke 3
, item dalam CheckBoxList kontrol ditampilkan dalam tiga kolom, seperti dalam tabel berikut.
1 | 4 | 7 |
2 | 5 | 8 |
3 | 6 | 9 |
Jika properti ini diatur ke RepeatDirection.Horizontal
dan jika RepeatLayout properti diatur ke Table, kolom pertama diisi dari atas ke bawah, maka kolom berikutnya, dan sebagainya hingga semua item dirender. Misalnya, jika RepeatColumns properti diatur ke 3
, item CheckBoxList kontrol ditampilkan dalam baris masing-masing tiga item, seperti dalam tabel berikut.
1 | 2 | 3 |
4 | 5 | 6 |
7 | 8 | 9 |