CheckBox controle de servidor Web Declarative sintaxe
Cria um controle de caixa de seleção que permite ao usuário comutador entre um true e um false estado.
<asp:CheckBox
AccessKey="string"
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"
Checked="True|False"
CssClass="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"
OnCheckedChanged="CheckedChanged event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
TextAlign="Left|Right"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Comentários
The CheckBox controle cria uma caixa de seleção na página Web Forms que permite ao usuário comutador entre um true e um false estado. Você pode especificar a legenda a ser exibida no controle definindo a Text propriedade. A legenda pode aparecer para a direita ou esquerda da caixa de seleção. conjunto o TextAlign propriedade para especificar o lado de onde a legenda aparece.
.gif "Observação") Observação: |
|---|
Porque o <asp:CheckBox> elemento não tem conteúdo, você pode fechar a marca com /> em vez de usar uma marca de fechamento separada. |
Para determinar se o CheckBox controle selecionado, teste a Checked propriedade. The CheckedChanged evento é gerado quando o estado das CheckBox controle for alterado entre postagens para o servidor. Você pode fornecer um manipulador de eventos para o CheckedChanged evento para executar uma determinada tarefa quando o estado das CheckBox controle for alterado entre postagens para o servidor.
| Observação: |
|---|
Ao criar vários CheckBox controles, você também pode usar o CheckBoxList controle. The CheckBoxList controle é mais fácil de usar para criar 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. |
Por padrão, a CheckBox controle não ocorra automaticamente POST o formulário ao servidor quando clicado. Para habilitar o lançamento automático, conjunto o AutoPostBack propriedade para true.
Aviso
O texto não é codificado antes que seja exibido em HTML a Controle CheckBox 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 CheckBox controle de servidor Web's propriedades e eventos, consulte o CheckBox documentação da classe.
Exemplo
O exemplo a seguir mostra uma declaração de exemplo para um CheckBox controle em um arquivo.aspx. A caixa de seleção está conjunto para lançar imediatamente o formulário ao servidor quando ele é selecionado.
<asp:CheckBox id="Check1" runat="server"
Text="CheckBox 1"
AutoPostBack="True"/>
<asp:CheckBox id="Check1" runat="server"
Text="CheckBox 1"
AutoPostBack="True"/>
O exemplo a seguir demonstra como criar um manipulador de eventos para o CheckedChanged evento para copiar o Sumário de uma caixa de texto que contém o endereço de cobrança de um cliente em uma caixa de texto que contém o endereço para entrega.
.gif "Observação de segurança") Observação de segurança: |
|---|
Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para obter mais informações, consulte Visão Geral de Scripts Maliciosos. |
<%@ 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>CheckBox Web Server Control Declarative Syntax</title>
<script runat="server">
Sub Check_Clicked(sender As Object, e As EventArgs)
If SameCheckBox.Checked Then
ShipTextBox.Text = BillTextBox.Text
Else
ShipTextBox.Text = ""
End If
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>CheckBox Example</h3>
<table>
<tr>
<td>
Billing Address: <br />
<asp:TextBox id="BillTextBox"
TextMode="MultiLine"
Rows="5"
runat="server"/>
</td>
<td>
Shipping Address: <br />
<asp:TextBox id="ShipTextBox"
TextMode="MultiLine"
Rows="5"
runat="server"/>
</td>
</tr>
<tr>
<td>
</td>
<td>
<asp:CheckBox id="SameCheckBox"
AutoPostBack="True"
Text="Same as billing."
TextAlign="Right"
OnCheckedChanged="Check_Clicked"
runat="server"/>
</td>
</tr>
</table>
</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>CheckBox Example</title>
<script runat="server">
void Check_Clicked(Object sender, EventArgs e)
{
if(SameCheckBox.Checked)
ShipTextBox.Text = BillTextBox.Text;
else
ShipTextBox.Text = "";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>CheckBox Example</h3>
<table>
<tr>
<td>
Billing Address: <br />
<asp:TextBox id="BillTextBox"
TextMode="MultiLine"
Rows="5"
runat="server"/>
</td>
<td>
Shipping Address: <br />
<asp:TextBox id="ShipTextBox"
TextMode="MultiLine"
Rows="5"
runat="server"/>
</td>
</tr>
<tr>
<td>
</td>
<td>
<asp:CheckBox id="SameCheckBox"
AutoPostBack="True"
Text="Same as billing."
TextAlign="Right"
OnCheckedChanged="Check_Clicked"
runat="server"/>
</td>
</tr>
</table>
</form>
</body>
</html>