CheckBoxField Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um campo booleano que é exibido como uma caixa de seleção num controlo ligado a dados.

public ref class CheckBoxField : System::Web::UI::WebControls::BoundField

public class CheckBoxField : System.Web.UI.WebControls.BoundField

type CheckBoxField = class
    inherit BoundField

Public Class CheckBoxField
Inherits BoundField

Herança: Object

DataControlField

BoundField
CheckBoxField

Exemplos

O exemplo de código seguinte demonstra como usar um objeto CheckBoxField num controlo GridView para mostrar um campo de uma fonte de dados Microsoft SQL Server com um tipo de dado Booleano.


<%@ 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>

Observações

A CheckBoxField classe é usada por controlos de dados limitados (como GridView e DetailsView) para mostrar o valor de um campo de dados booleano numa caixa de seleção. O CheckBoxField objeto é apresentado de forma diferente consoante o controlo limitado por dados em que é utilizado. Por exemplo, o controlo GridView apresenta um CheckBoxField objeto como uma coluna, enquanto o DetailsView controlo o apresenta como uma linha.

Note

Uma caixa de seleção está desativada (apenas leitura) até que o controlo de dados exiba um registo que contenha a caixa de seleção em modo de edição. Para mais informações sobre como colocar um registo em modo de edição, consulte a documentação do controlo parental que contém o CheckBoxField objeto.

Para especificar o campo a mostrar num CheckBoxField objeto, defina a DataField propriedade com o nome do campo.

Note

Como uma caixa de seleção só pode mostrar um estado selecionado ou não selecionado, um CheckBoxField objeto pode ser atribuído apenas a um campo com um tipo de dado booleano ou uma cadeia que possa ser analisada por Parse.

Pode mostrar uma legenda ao lado de cada caixa de seleção definindo a Text propriedade. Um CheckBoxField objeto está oculto num controlo ligado a dados quando a Visible propriedade está definida para false. Para evitar que o valor de um campo seja modificado no modo de edição, defina a ReadOnly propriedade para true. Em controlos data-bound que suportam inserir registos (como o DetailsView controlo), pode esconder um CheckBoxField objeto em modo insert definindo a InsertVisible propriedade para false.

Podes personalizar as secções de cabeçalho e rodapé de um CheckBoxField objeto. Para mostrar uma legenda nas secções do cabeçalho ou rodapé, defina as HeaderText propriedades ou FooterText , respetivamente. Em vez de mostrar texto na secção do cabeçalho, pode mostrar uma imagem definindo a HeaderImageUrl propriedade. A secção do cabeçalho pode ser ocultada no CheckBoxField objeto ao definir a ShowHeader propriedade para false.

Note

Alguns controlos ligados a dados (como o controlo GridView ) podem mostrar ou ocultar apenas toda a secção do cabeçalho do controlo. Estes controlos ligados a dados não suportam a ShowHeader propriedade para um campo ligado individual. Para mostrar ou ocultar toda a secção do cabeçalho de um controlo ligado a dados (se disponível), use a propriedade do ShowHeader controlo.

Também pode personalizar a aparência do CheckBoxField objeto (cor da fonte, cor de fundo, etc.) definindo as propriedades de estilo para as diferentes partes do campo. A tabela seguinte lista as diferentes propriedades de estilo.

Propriedade de estilo	Description
ControlStyle	As definições de estilo do servidor Web filho controlam o CheckBoxField objeto.
FooterStyle	As definições de estilo para a secção do rodapé do CheckBoxField objeto.
HeaderStyle	As definições de estilo para a secção do cabeçalho do CheckBoxField objeto.
ItemStyle	As definições de estilo para os itens de dados no CheckBoxField objeto.

Construtores

Name	Description
CheckBoxField()	Inicializa uma nova instância da CheckBoxField classe.

Propriedades

Name	Description
AccessibleHeaderText	Recebe ou define texto que é renderizado como valor de `AbbreviatedText` propriedade em alguns controlos. (Herdado de DataControlField)
ApplyFormatInEditMode	Sobrepõe-se à propriedade ApplyFormatInEditMode . Esta propriedade não é suportada pela CheckBoxField classe.
Control	Obtém uma referência ao controlo de dados ao qual o DataControlField objeto está associado. (Herdado de DataControlField)
ControlStyle	Obtém o estilo de quaisquer controlos de servidor Web contidos pelo DataControlField objeto. (Herdado de DataControlField)
ConvertEmptyStringToNull	Sobrepõe-se à propriedade ConvertEmptyStringToNull . Esta propriedade não é suportada pela CheckBoxField classe.
DataField	Obtém ou define o nome do campo de dados para se ligar ao CheckBoxField objeto.
DataFormatString	Obtém ou define a cadeia que especifica o formato de exibição para o valor do campo. Esta propriedade não é suportada pela CheckBoxField classe.
DesignMode	Obtém um valor que indica se um campo de controlo de dados está atualmente visualizado num ambiente em tempo de design. (Herdado de DataControlField)
FooterStyle	Obtém ou define o estilo do rodapé do campo de controlo de dados. (Herdado de DataControlField)
FooterText	Recebe ou define o texto que é exibido no elemento de rodapé de um campo de controlo de dados. (Herdado de DataControlField)
HeaderImageUrl	Obtém ou define a URL de uma imagem que é exibida no elemento do cabeçalho de um campo de controlo de dados. (Herdado de DataControlField)
HeaderStyle	Obtém ou define o estilo do cabeçalho do campo de controlo de dados. (Herdado de DataControlField)
HeaderText	Recebe ou define o texto que é exibido no cabeçalho de um controlo de dados. (Herdado de BoundField)
HtmlEncode	Sobrepõe-se à propriedade HtmlEncode . Esta propriedade não é suportada pela CheckBoxField classe.
HtmlEncodeFormatString	Recebe ou define um valor que indica se o texto formatado deve ser codificado em HTML antes de ser exibido.
InsertVisible	Recebe um valor que indica se o DataControlField objeto é visível quando o controlo de dados do pai está em modo de inserção. (Herdado de DataControlField)
IsTrackingViewState	Recebe um valor que indica se o DataControlField objeto está a guardar alterações ao seu estado de visualização. (Herdado de DataControlField)
ItemStyle	Obtém o estilo de qualquer conteúdo baseado em texto apresentado por um campo de controlo de dados. (Herdado de DataControlField)
NullDisplayText	Obtém ou define o texto apresentado para um campo quando o valor do campo é `null`. Esta propriedade não é suportada pela CheckBoxField classe.
ReadOnly	Recebe ou define um valor que indica se o valor do campo pode ser modificado em modo de edição. (Herdado de BoundField)
ShowHeader	Recebe ou define um valor que indica se o elemento do cabeçalho de um campo de controlo de dados é renderizado. (Herdado de DataControlField)
SortExpression	Obtém ou define uma expressão de ordenação que é usada por um controlo de fonte de dados para ordenar dados. (Herdado de DataControlField)
SupportsHtmlEncode	Recebe um valor booleano a indicar se o controlo suporta codificação HTML.
Text	Recebe ou define a legenda para ser exibida ao lado de cada caixa de seleção num CheckBoxField objeto.
ValidateRequestMode	Recebe ou define um valor que determina se o controlo valida ou não a entrada do cliente. (Herdado de BoundField)
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um DataControlField objeto através de múltiplos pedidos para a mesma página. (Herdado de DataControlField)
Visible	Recebe ou define um valor que indica se um campo de controlo de dados é renderizado. (Herdado de DataControlField)

Métodos

Name	Description
CloneField()	Cria uma cópia duplicada do objeto derivado atualmente DataControlField. (Herdado de DataControlField)
CopyProperties(DataControlField)	Copia as propriedades do objeto atual CheckBoxField para o objeto especificado DataControlField .
CreateField()	Cria um objeto vazio CheckBoxField .
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 do 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 num designer.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(Control)	Recupera o valor do campo ligado 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 a informação de estado de visualização previamente armazenada para este campo. (Herdado de BoundField)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnDataBindField(Object, EventArgs)	Atribui o valor de um campo a uma caixa de seleção no CheckBoxField objeto.
OnFieldChanged()	Eleva o `FieldChanged` evento. (Herdado de DataControlField)
SaveViewState()	Guarda as alterações feitas ao DataControlField estado de visualização desde o momento em que a página foi publicada de volta no servidor. (Herdado de DataControlField)
ToString()	Devolve uma cadeia que representa este DataControlField objeto. (Herdado de DataControlField)
TrackViewState()	Faz com que o DataControlField objeto acompanhe alterações ao estado da visualização para que possam ser armazenadas na propriedade do ViewState controlo e persistirem entre pedidos para a mesma página. (Herdado de DataControlField)
ValidateSupportsCallback()	Determina se os controlos contidos num CheckBoxField objeto suportam callbacks.

Implementações de Interface Explícita

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtém ou define o esquema associado a este DataControlField objeto. (Herdado de DataControlField)
IStateManager.IsTrackingViewState	Recebe um valor que indica se o DataControlField objeto está a guardar alterações ao seu estado de visualização. (Herdado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura o estado de visualização previamente guardado do campo de controlo de dados. (Herdado de DataControlField)
IStateManager.SaveViewState()	Guarda as alterações feitas ao DataControlField estado de visualização desde o momento em que a página foi publicada de volta no servidor. (Herdado de DataControlField)
IStateManager.TrackViewState()	Faz com que o DataControlField objeto acompanhe alterações ao estado da visualização para que possam ser armazenadas na propriedade do ViewState controlo e persistirem entre pedidos para a mesma página. (Herdado de DataControlField)

Aplica-se a

Ver também

Comentários

Esta página foi útil?