BoundField Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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 exibido como texto em um controle de associação de dados.

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

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

type BoundField = class
    inherit DataControlField

Public Class BoundField
Inherits DataControlField

Herança: Object

DataControlField
BoundField

Derivado: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Exemplos

O exemplo de código a seguir demonstra como usar um BoundField objeto para exibir os valores de um campo em um GridView controle.


<%@ 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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Comentários

A BoundField classe é usada por controles associados a dados (como GridView e DetailsView) para exibir o valor de um campo como texto. O BoundField objeto é exibido de forma diferente dependendo do controle associado a dados no qual ele é usado. Por exemplo, o GridView controle exibe um BoundField objeto como uma coluna, enquanto o controle o DetailsView exibe como uma linha.

Para especificar o campo a ser exibido em um BoundField objeto, defina a DataField propriedade como o nome do campo. O valor do campo pode ser codificado em HTML antes de ser exibido definindo a HtmlEncode propriedade como true. Você pode aplicar uma cadeia de caracteres de formatação personalizada ao valor do campo definindo a DataFormatString propriedade. Quando a HtmlEncode propriedade é true, o valor de cadeia de caracteres codificado do campo é usado na cadeia de caracteres de formato personalizado. Por padrão, a cadeia de caracteres de formatação é aplicada a valores de campo somente quando o controle associado a dados está no modo somente leitura. Para aplicar a cadeia de caracteres de formatação a valores exibidos enquanto o controle associado a dados estiver no modo de edição, defina a ApplyFormatInEditMode propriedade como true. Se o valor de um campo for nulo, você poderá exibir uma legenda personalizada definindo a NullDisplayText propriedade. O BoundField objeto também pode converter automaticamente valores de campo de cadeia de caracteres vazias ("") em valores nulos definindo a ConvertEmptyStringToNull propriedade como true.

Você pode ocultar um BoundField objeto em um controle associado a dados definindo a Visible propriedade 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 BoundField objeto definindo a InsertVisible propriedade como false. Isso geralmente é feito quando você deseja ocultar um campo de chave gerado automaticamente no modo de inserção.

Você pode personalizar as seções de cabeçalho e rodapé de um BoundField 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 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 BoundField 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 BoundField 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 diferentes propriedades de estilo.

Propriedade Style	Descrição
ControlStyle	As configurações de estilo para os controles filho do servidor Web do BoundField objeto.
FooterStyle	As configurações de estilo para a seção de rodapé do BoundField objeto.
HeaderStyle	As configurações de estilo para a seção de cabeçalho do BoundField objeto.
ItemStyle	As configurações de estilo para os itens de dados no BoundField objeto.

Construtores

BoundField()

Inicializa uma nova instância da classe BoundField.

Campos

ThisExpression

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

Representa a expressão "this".

Propriedades

AccessibleHeaderText	Obtém ou define o texto que é renderizado como o valor da propriedade `AbbreviatedText` em alguns controles. (Herdado de DataControlField)
ApplyFormatInEditMode	Obtém ou define um valor que indica se a cadeia de caracteres de formatação especificada pela propriedade DataFormatString é aplicada aos valores de campo quando o controle associado de dados que contém o objeto BoundField está no modo de edição.
Control	Obtém uma referência ao controle de dados ao qual o objeto DataControlField está associado. (Herdado de DataControlField)
ControlStyle	Obtém o estilo de qualquer controle do servidor Web contido pelo objeto DataControlField. (Herdado de DataControlField)
ConvertEmptyStringToNull	Obtém ou define um valor que indica se valores de cadeia de caracteres vazia ("") são automaticamente convertidos em valores nulos quando o campo de dados é atualizado na fonte de dados.
DataField	Obtém ou define o nome do campo de dados a ser associado ao objeto BoundField.
DataFormatString	Obtém ou define a cadeia de caracteres que especifica o formato de exibição do valor do campo.
DesignMode	Obtém um valor que indica se um campo de controle de dados é atualmente exibido 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.
HtmlEncode	Obtém ou define um valor que indica se os valores de campo são codificados em HTML antes que eles sejam exibidos em um objeto BoundField.
HtmlEncodeFormatString	Obtém ou define um valor que indica se o texto criado aplicando a propriedade DataFormatString ao valor BoundField deve ser codificado em HTML quando for exibido.
InsertVisible	Obtém um valor que indica se o objeto DataControlField fica visível quando o controle associado a dados pai está no modo de inserção. (Herdado de DataControlField)
IsTrackingViewState	Obtém um valor que indica se o objeto DataControlField está salvando alterações no 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 a legenda exibida em um campo quando o valor do campo é null.
ReadOnly	Obtém ou define um valor que indica se o valor do campo pode ser modificado no modo de edição.
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 que é usada por um controle de fonte de dados para classificar os dados. (Herdado de DataControlField)
SupportsHtmlEncode	Obtém um valor que indica se a codificação HTML tiver suporte por um objeto de BoundField.
ValidateRequestMode	Obtém ou define um valor que determina se o controle valida a entrada de cliente ou não.
ValidateRequestMode	Obtém ou define um valor que especifica se o controle valida a entrada do cliente. (Herdado de DataControlField)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um objeto DataControlField em várias solicitações da 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

CloneField()	Cria uma cópia duplicada do objeto atual derivado de DataControlField. (Herdado de DataControlField)
CopyProperties(DataControlField)	Copia as propriedades do objeto BoundField atual para o objeto DataControlField especificado.
CreateField()	Cria um objeto BoundField vazio.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Preenche o objeto IDictionary especificado com os valores do objeto TableCell especificado.
FormatDataValue(Object, Boolean)	Formata o valor do campo especificado para uma célula no objeto de BoundField.
GetDesignTimeValue()	Recupera o valor usado para um valor de campo ao renderizar o objeto de BoundField 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 objeto de BoundField.
Initialize(Boolean, Control)	Inicializa o objeto BoundField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializa o objeto TableCell especificado no estado de linha especificado.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializa o objeto TableCell especificado no estado de linha especificado.
LoadViewState(Object)	Restaura as informações de estado de exibição armazenadas anteriormente para esse campo.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDataBindField(Object, EventArgs)	Associa o valor de um campo ao objeto de BoundField.
OnFieldChanged()	Aciona o evento `FieldChanged`. (Herdado de DataControlField)
SaveViewState()	Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor. (Herdado de DataControlField)
ToString()	Retorna uma cadeia de caracteres que representa este objeto DataControlField. (Herdado de DataControlField)
TrackViewState()	Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de DataControlField)
ValidateSupportsCallback()	Determina se os controles contidos em um objeto BoundField dão suporte a retornos de chamada.

Implantações explícitas de interface

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtém ou define o esquema associado a este objeto DataControlField. (Herdado de DataControlField)
IStateManager.IsTrackingViewState	Obtém um valor que indica se o objeto DataControlField está salvando alterações no 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 a hora em que a página foi postada de volta no servidor. (Herdado de DataControlField)
IStateManager.TrackViewState()	Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de DataControlField)

Aplica-se a