CheckBoxList controle de servidor Web Declarative sintaxe
Cria um agrupar de caixa de seleção seleção múltipla. Esse controle suporta ligação a uma fonte de dados.
<asp:CheckBoxList
AccessKey="string"
AppendDataBoundItems="True|False"
AutoPostBack="True|False"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DataTextField="string"
DataTextFormatString="string"
DataValueField="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnTextChanged="TextChanged event handler"
OnUnload="Unload event handler"
RepeatColumns="integer"
RepeatDirection="Horizontal|Vertical"
RepeatLayout="Table|Flow"
runat="server"
SelectedIndex="integer"
SelectedValue="string"
SkinID="string"
Style="string"
TabIndex="integer"
TextAlign="Left|Right"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
>
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="string"
Value="string"
/>
</asp:CheckBoxList>
Comentários
The CheckBoxList controle cria um agrupar de caixa de seleção seleção múltipla que pode ser gerado dinamicamente usando vinculação de dados. Para especificar itens que você deseja que apareça no CheckBoxList controlar, coloque um ListItem elemento para cada entrada entre as Rótulos de abertura e fechamento das CheckBoxList controle.
.gif "Observação") Observação: |
|---|
Você também pode usar vários CheckBox controles. The CheckBoxList o controle é mais fácil para a criação de um conjunto de caixas de seleção usando vinculação de dados, enquanto o indivíduo CheckBox controle oferece a você maior controle sobre o layout. |
The CheckBoxList controle também suporta vinculação de dados. Para BIND o controle a uma fonte de dados, primeiro crie uma fonte de dados, por exemplo, um a DataSourceControl objetos, que contém sistema autônomo itens a serem exibidos no controle. Em seguida, use o DataBind método para BIND a fonte de dados para o CheckBoxList controle. Use o DataTextField e DataValueField propriedades para especificar qual campo na fonte de dados para BIND a Text e Value Propriedades de cada listam item no controle, respectivamente. The CheckBoxList Agora o controle exibirá as informações da fonte de dados.
Para determinar os itens selecionados no CheckBoxList controlar, fazer uma iteração através da Items coleta e teste a Selected propriedade de cada item na coleção.
Você pode especificar o modo de que exibição lista, usando o RepeatLayout e RepeatDirection Propriedades. If RepeatLayout é conjunto para RepeatLayout.Table (a padrão conjunto seletiva), a lista é processada dentro de uma tabela. Se ele estiver definido como RepeatLayout.Flow, a lista é processada sem nenhuma estrutura de tabela. Por padrão, RepeatDirection é conjunto para RepeatDirection.Vertical. A definição dessa propriedade como RepeatDirection.Horizontal processa a lista horizontalmente.
Aviso
O texto não é codificado antes que seja exibido em HTML a Controle CheckBoxList Isso torna possível incorporar o script nas Rótulos HTML no texto. Se os valores para o controle provenientes da entrada do usuário, certifique-se de validar os valores para ajudar a evitar vulnerabilidades de segurança.
Para obter informações detalhadas sobre o CheckBoxList Propriedades e eventos de controle de servidor de Web, consulte o CheckBoxList documentação da classe.
Exemplo
The following shows a sample declaration for a CheckBoxListcontrol in an .aspx file. A lista contém seis itens que não são mutuamente exclusivo. Quando um usuário faz uma das caixas, a página imediatamente não é remetida para o servidor (a página não estiver disponível até que ocorra algum Outros evento, sistema autônomo um Button clicar). No OnSelectedIndexChanged manipulador de eventos é chamado porque nenhum método foi declarado para esse evento.
<asp:CheckBoxList id="Check1"
RepeatLayout="flow"
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>
<asp:CheckBoxList id="Check1"
RepeatLayout="flow"
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>
O exemplo a seguir mostra como você pode determinar as caixas de seleção marcadas em um CheckBoxList controle. O código interage através Items coleção e testar cada item Selected propriedade. Os itens selecionados são exibidos no Label controle.
Sub Button1_OnClick(ByVal sender As Object, ByVal e As EventArgs)
Dim s As String
Dim i As Integer
s = "Selected items:<br />"
For i = 0 To Check1.Items.Count - 1
If Check1.Items(i).Selected Then
s = s & Check1.Items(i).Text & "<br />"
End If
Next i
Label1.Text = s
End Sub
void Button1_OnClick(Object sender, EventArgs e)
{
string s;
s = "Selected items:<br />";
for (int i = 0; i < Check1.Items.Count; i++)
{
if (Check1.Items[i].Selected)
{
s = s + Check1.Items[i].Text + "<br />";
}
}
Label1.Text = s;
}