CheckBoxField Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa um campo booliano exibido como uma caixa de seleção em um controle associado a dados.
public ref class CheckBoxField : System::Web::UI::WebControls::BoundFieldpublic class CheckBoxField : System.Web.UI.WebControls.BoundFieldtype CheckBoxField = class
inherit BoundFieldPublic Class CheckBoxField
Inherits BoundField- Herança
Exemplos
O exemplo de código a seguir demonstra como usar um CheckBoxField objeto em um GridView controle para exibir um campo de uma fonte de dados do Microsoft SQL Server com um tipo de dados booliano.
<%@ Page language="C#" %>
<!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>CheckBoxField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CheckBoxField Example</h3>
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="False"
runat="server">
<columns>
<asp:boundfield datafield="au_lname"
headertext="Last Name"/>
<asp:checkboxfield datafield="contract"
text="Contract"
headertext="Contract"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!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>CheckBoxField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CheckBoxField Example</h3>
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="False"
runat="server">
<columns>
<asp:boundfield datafield="au_lname"
headertext="Last Name"/>
<asp:checkboxfield datafield="contract"
text="Contract"
headertext="Contract"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Comentários
A CheckBoxField classe é usada por controles associados a dados (como GridView e DetailsView) para exibir o valor de um campo de dados booliano em uma caixa de seleção. O CheckBoxField objeto é exibido de forma diferente dependendo do controle associado a dados no qual ele é usado. Por exemplo, o GridView controle exibe um CheckBoxField objeto como uma coluna, enquanto o controle o DetailsView exibe como uma linha.
Observação
Uma caixa de seleção é desabilitada (somente leitura) até que o controle associado a dados exiba um registro que contenha a caixa de seleção no modo de edição. Para obter mais informações sobre como colocar um registro no modo de edição, consulte a documentação do controle pai que contém o CheckBoxField objeto.
Para especificar o campo a ser exibido em um CheckBoxField objeto, defina a DataField propriedade com o nome do campo.
Observação
Como uma caixa de seleção pode exibir apenas um estado selecionado ou não selecionado, um CheckBoxField objeto só pode ser associado a um campo com um tipo de dados booliano ou uma cadeia de caracteres que pode ser analisada por Parse.
Você pode exibir uma legenda ao lado de cada caixa de seleção definindo a Text propriedade. Um CheckBoxField objeto fica oculto em um controle associado a dados quando a Visible propriedade é definida como false. Para impedir que o valor de um campo seja modificado no modo de edição, defina a ReadOnly propriedade como true. Em controles associados a dados que dão suporte à inserção de registros (como o DetailsView controle), você pode ocultar um CheckBoxField objeto no modo de inserção definindo a InsertVisible propriedade como false.
Você pode personalizar as seções de cabeçalho e rodapé de um CheckBoxField objeto. Para exibir uma legenda nas seções de cabeçalho ou rodapé, defina as propriedades ou FooterText as HeaderText propriedades, respectivamente. Em vez de exibir o texto na seção de cabeçalho, você pode exibir uma imagem definindo a HeaderImageUrl propriedade. A seção de cabeçalho pode ser oculta no CheckBoxField objeto definindo a ShowHeader propriedade como false.
Observação
Alguns controles associados a dados (como o GridView controle) podem mostrar ou ocultar apenas toda a seção de cabeçalho do controle. Esses controles associados a dados não dão suporte à ShowHeader propriedade para um campo associado individual. Para mostrar ou ocultar toda a seção de cabeçalho de um controle associado a dados (se disponível), use a propriedade do ShowHeader controle.
Você também pode personalizar a aparência do objeto (cor da CheckBoxField fonte, cor da tela de fundo e assim por diante) definindo as propriedades de estilo para as diferentes partes do campo. A tabela a seguir lista as propriedades de estilo diferentes.
| Propriedade Style | Descrição |
|---|---|
| ControlStyle | As configurações de estilo para os controles do servidor Web filho do CheckBoxField objeto. |
| FooterStyle | As configurações de estilo para a seção rodapé do CheckBoxField objeto. |
| HeaderStyle | As configurações de estilo para a seção de cabeçalho do CheckBoxField objeto. |
| ItemStyle | As configurações de estilo para os itens de dados no CheckBoxField objeto. |
Construtores
| Nome | Description |
|---|---|
| CheckBoxField() |
Inicializa uma nova instância da classe CheckBoxField. |
Propriedades
| Nome | Description |
|---|---|
| AccessibleHeaderText |
Obtém ou define o texto renderizado como o valor da |
| ApplyFormatInEditMode |
Substitui a ApplyFormatInEditMode propriedade. Essa propriedade não tem suporte da CheckBoxField classe. |
| Control |
Obtém uma referência ao controle de dados ao qual o DataControlField objeto está associado. (Herdado de DataControlField) |
| ControlStyle |
Obtém o estilo de todos os controles de servidor Web contidos pelo DataControlField objeto. (Herdado de DataControlField) |
| ConvertEmptyStringToNull |
Substitui a ConvertEmptyStringToNull propriedade. Essa propriedade não tem suporte da CheckBoxField classe. |
| DataField |
Obtém ou define o nome do campo de dados a ser associado ao CheckBoxField objeto. |
| DataFormatString |
Obtém ou define a cadeia de caracteres que especifica o formato de exibição para o valor do campo. Essa propriedade não tem suporte da CheckBoxField classe. |
| DesignMode |
Obtém um valor que indica se um campo de controle de dados é exibido no momento em um ambiente de tempo de design. (Herdado de DataControlField) |
| FooterStyle |
Obtém ou define o estilo do rodapé do campo de controle de dados. (Herdado de DataControlField) |
| FooterText |
Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados. (Herdado de DataControlField) |
| HeaderImageUrl |
Obtém ou define a URL de uma imagem exibida no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField) |
| HeaderStyle |
Obtém ou define o estilo do cabeçalho do campo de controle de dados. (Herdado de DataControlField) |
| HeaderText |
Obtém ou define o texto exibido no cabeçalho de um controle de dados. (Herdado de BoundField) |
| HtmlEncode |
Substitui a HtmlEncode propriedade. Essa propriedade não tem suporte da CheckBoxField classe. |
| HtmlEncodeFormatString |
Obtém ou define um valor que indica se o texto formatado deve ser codificado em HTML antes de ser exibido. |
| InsertVisible |
Obtém um valor que indica se o DataControlField objeto está visível quando seu controle associado a dados pai está no modo de inserção. (Herdado de DataControlField) |
| IsTrackingViewState |
Obtém um valor que indica se o DataControlField objeto está salvando alterações em seu estado de exibição. (Herdado de DataControlField) |
| ItemStyle |
Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados. (Herdado de DataControlField) |
| NullDisplayText |
Obtém ou define o texto exibido para um campo quando o valor do campo é |
| ReadOnly |
Obtém ou define um valor que indica se o valor do campo pode ser modificado no modo de edição. (Herdado de BoundField) |
| ShowHeader |
Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é renderizado. (Herdado de DataControlField) |
| SortExpression |
Obtém ou define uma expressão de classificação usada por um controle de fonte de dados para classificar dados. (Herdado de DataControlField) |
| SupportsHtmlEncode |
Obtém um valor booliano que indica se o controle dá suporte à codificação HTML. |
| Text |
Obtém ou define a legenda a ser exibida ao lado de cada caixa de seleção em um CheckBoxField objeto. |
| ValidateRequestMode |
Obtém ou define um valor que determina se o controle valida a entrada do cliente ou não. (Herdado de BoundField) |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um DataControlField objeto em várias solicitações para a mesma página. (Herdado de DataControlField) |
| Visible |
Obtém ou define um valor que indica se um campo de controle de dados é renderizado. (Herdado de DataControlField) |
Métodos
| Nome | Description |
|---|---|
| CloneField() |
Cria uma cópia duplicada do objeto derivado atual DataControlField. (Herdado de DataControlField) |
| CopyProperties(DataControlField) |
Copia as propriedades do objeto atual CheckBoxField para o objeto especificado DataControlField . |
| CreateField() |
Cria um objeto CheckBoxField vazio. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Preenche o objeto especificado IDictionary com os valores do objeto especificado DataControlFieldCell . |
| FormatDataValue(Object, Boolean) |
Formata o valor de campo especificado para uma célula no BoundField objeto. (Herdado de BoundField) |
| GetDesignTimeValue() |
Recupera o valor usado para o valor do campo ao renderizar o CheckBoxField objeto em um designer. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(Control) |
Recupera o valor do campo associado ao BoundField objeto. (Herdado de BoundField) |
| Initialize(Boolean, Control) |
Inicializa o objeto BoundField. (Herdado de BoundField) |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inicializa o objeto especificado TableCell para o estado da linha especificado. (Herdado de BoundField) |
| InitializeDataCell(DataControlFieldCell, DataControlRowState) |
Inicializa o objeto especificado DataControlFieldCell para o estado da linha especificado. |
| LoadViewState(Object) |
Restaura as informações de estado de exibição armazenadas anteriormente para este campo. (Herdado de BoundField) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnDataBindField(Object, EventArgs) |
Associa o valor de um campo a uma caixa de seleção no CheckBoxField objeto. |
| OnFieldChanged() |
Aciona o evento |
| SaveViewState() |
Salva as alterações feitas no estado de exibição DataControlField desde o momento em que a página foi postada de volta no servidor. (Herdado de DataControlField) |
| ToString() |
Retorna uma cadeia de caracteres que representa esse DataControlField objeto. (Herdado de DataControlField) |
| TrackViewState() |
Faz com que o DataControlField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataControlField) |
| ValidateSupportsCallback() |
Determina se os controles contidos em um CheckBoxField objeto dão suporte a retornos de chamada. |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Obtém ou define o esquema associado a esse DataControlField objeto. (Herdado de DataControlField) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se o DataControlField objeto está salvando alterações em seu estado de exibição. (Herdado de DataControlField) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente do campo de controle de dados. (Herdado de DataControlField) |
| IStateManager.SaveViewState() |
Salva as alterações feitas no estado de exibição DataControlField desde o momento em que a página foi postada de volta no servidor. (Herdado de DataControlField) |
| IStateManager.TrackViewState() |
Faz com que o DataControlField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataControlField) |
