Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe BoundField

Representa um campo que é exibido como texto em um controle ligado a dados.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

public class BoundField : DataControlField

O tipo BoundField expõe os membros a seguir.

  NomeDescrição
Método públicoBoundFieldInicializa uma nova instância da classe BoundField.
Superior

  NomeDescrição
Propriedade públicaAccessibleHeaderTextObtém ou define o texto que é processado como o AbbreviatedText o valor da propriedade em alguns controles. (Herdado de DataControlField.)
Propriedade públicaApplyFormatInEditModeObtém ou define um valor que indica se a seqüência de caracteres de formatação especificados pela DataFormatString propriedade é aplicada aos valores de campo quando o controle ligado a dados que contém o BoundField objeto está no modo de edição.
Propriedade protegidaControlObtém uma referência ao controle de dados que o DataControlField objeto é associado. (Herdado de DataControlField.)
Propriedade públicaControlStyleObtém o estilo de quaisquer controles de servidor Web contido pelo DataControlField objeto. (Herdado de DataControlField.)
Propriedade públicaConvertEmptyStringToNullObtém ou define um valor indicando se esvaziar os valores de seqüência de caracteres ("") são automaticamente convertidas em valores nulos, quando o campo de dados é atualizado na fonte de dados.
Propriedade públicaDataFieldObtém ou define o nome do campo de dados para vincular a BoundField objeto.
Propriedade públicaDataFormatStringObtém ou define a seqüência de caracteres que especifica o formato de exibição para o valor do campo.
Propriedade protegidaDesignModeObtém um valor que indica se um campo de controle de dados atualmente é exibido em um ambiente de tempo de design. (Herdado de DataControlField.)
Propriedade públicaFooterStyleObtém ou define o estilo do rodapé do campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaFooterTextObtém ou define o texto que é exibido no item de rodapé de um campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaHeaderImageUrlObtém ou define o URL de uma imagem que é exibida no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaHeaderStyleObtém ou define o estilo do cabeçalho do campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaHeaderTextObtém ou define o texto que é exibido no cabeçalho de um controle de dados. (Substitui DataControlField.HeaderText.)
Propriedade públicaHtmlEncodeObtém ou define um valor indicando se os valores do campo são códigos HTML para demonstração antes que eles sejam exibidos em um objeto BoundField.
Propriedade públicaHtmlEncodeFormatStringObtém ou define um valor que indica se texto que é criada aplicando-o DataFormatString propriedade para o BoundField o valor deve ser codificado em HTML quando ela é exibida.
Propriedade públicaInsertVisibleObtém um valor indicando se a DataControlField objeto estará visível quando o controle ligado a dados pai está no modo de inserção. (Herdado de DataControlField.)
Propriedade protegidaIsTrackingViewStateObtém um valor indicando se a DataControlField objeto está salvando as alterações ao seu estado de exibição. (Herdado de DataControlField.)
Propriedade públicaItemStyleObtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaNullDisplayTextObtém ou define a legenda exibida para um campo quando o valor do campo é nulo.
Propriedade públicaReadOnlyObtém ou define um valor que indica se o valor do campo pode ser modificado no modo de edição.
Propriedade públicaShowHeaderObtém ou define um valor indicando se o item de cabeçalho de um campo de dados de controle é processado. (Herdado de DataControlField.)
Propriedade públicaSortExpressionObté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.)
Propriedade protegidaSupportsHtmlEncodeObtém um valor indicando se a codificação HTML é oferecido por um BoundField objeto.
Propriedade públicaValidateRequestModeObtém ou define um valor que determina se o controle valida a entrada do cliente ou não.
Propriedade protegidaViewStateObtém um dicionário de informações de estado que permite que você salvar e restaurar o estado de exibição de um DataControlField objeto nas várias solicitações para a mesma página. (Herdado de DataControlField.)
Propriedade públicaVisibleObtém ou define um valor indicando se um campo de dados de controle é processado. (Herdado de DataControlField.)
Superior

  NomeDescrição
Método protegidoCloneFieldInfraestrutura. Cria uma cópia duplicada do atual DataControlField-derivado do objeto. (Herdado de DataControlField.)
Método protegidoCopyPropertiesCopia as propriedades do atual BoundField o objeto para o DataControlField objeto. (Substitui DataControlField.CopyProperties(DataControlField).)
Método protegidoCreateFieldCria um vazio BoundField objeto. (Substitui DataControlField.CreateField().)
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método públicoExtractValuesFromCellPreenche o especificado System.Collections.IDictionary o objeto com os valores do especificado TableCell objeto. (Substitui DataControlField.ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean).)
Método protegidoFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método protegidoFormatDataValueFormata o valor do campo especificado de uma célula na BoundField objeto.
Método protegidoGetDesignTimeValueRecupera o valor usado para o valor de um campo ao renderizar o BoundField o objeto em um designer.
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoGetValueRecupera o valor do campo acoplado como o BoundField objeto.
Método públicoInitializeInicializa o BoundField objeto. (Substitui DataControlField.Initialize(Boolean, Control).)
Método públicoInitializeCellInicializa o especificado TableCell objeto para o estado da linha especificada. (Substitui DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).)
Método protegidoInitializeDataCellInicializa o especificado TableCell objeto para o estado da linha especificada.
Método protegidoLoadViewStateRestaura as informações de estado de exibição armazenadas anteriormente para esse campo. (Substitui DataControlField.LoadViewState(Object).)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método protegidoOnDataBindFieldVincula o valor de um campo para o BoundField objeto.
Método protegidoOnFieldChangedGera o evento FieldChanged. (Herdado de DataControlField.)
Método protegidoSaveViewStateSalva as alterações feitas a DataControlField estado de exibição desde o momento em que a página foi postada de volta para o servidor. (Herdado de DataControlField.)
Método públicoToStringRetorna um string que representa esse DataControlField objeto. (Herdado de DataControlField.)
Método protegidoTrackViewStateFaz com que o DataControlField o objeto para controlar alterações ao seu estado de exibição para que eles podem ser armazenados no controle de ViewState propriedade e persistentes entre as solicitações para a mesma página. (Herdado de DataControlField.)
Método públicoValidateSupportsCallbackDetermina se os controles contidos em um BoundField suporte a retornos de chamada de objeto. (Substitui DataControlField.ValidateSupportsCallback().)
Superior

  NomeDescrição
Campo públicoMembro estáticoThisExpressionInfraestrutura. Representa a expressão "this".
Superior

  NomeDescrição
Implementação explícita da interfacePropriedade particularIDataSourceViewSchemaAccessor.DataSourceViewSchemaInfraestrutura. Obtém ou define o esquema associado a isso DataControlField objeto. (Herdado de DataControlField.)
Implementação explícita da interfacePropriedade particularIStateManager.IsTrackingViewStateInfraestrutura. Obtém um valor indicando se a DataControlField objeto está salvando as alterações ao seu estado de exibição. (Herdado de DataControlField.)
Implementação explícita da interfaceMétodo particularIStateManager.LoadViewStateInfraestrutura. Restaura o estado de exibição salva anteriormente no campo controle de dados. (Herdado de DataControlField.)
Implementação explícita da interfaceMétodo particularIStateManager.SaveViewStateInfraestrutura. Salva as alterações feitas a DataControlField estado de exibição desde o momento em que a página foi postada de volta para o servidor. (Herdado de DataControlField.)
Implementação explícita da interfaceMétodo particularIStateManager.TrackViewStateInfraestrutura. Faz com que o DataControlField o objeto para controlar alterações ao seu estado de exibição para que eles podem ser armazenados no controle de ViewState propriedade e persistentes entre as solicitações para a mesma página. (Herdado de DataControlField.)
Superior

O BoundField classe é usada pelos controles ligados a dados (como GridView e DetailsView) para exibir o valor de um campo como texto. O BoundField o objeto é exibido de maneira diferente dependendo do controle ligado a dados em que ele é usado. Por exemplo, o GridView controle exibe um BoundField o objeto como uma coluna, enquanto o DetailsView controle exibe como uma linha.

Para especificar o campo para exibir em um BoundField de objeto, defina a DataField propriedade para o nome do campo. O valor do campo pode ser codificado em HTML antes que seja exibido, definindo a HtmlEncode propriedade para true. Você pode aplicar uma seqüência de formatação personalizada para o valor do campo definindo a DataFormatString propriedade. Quando o HtmlEncode propriedade é true, o valor de seqüência de caracteres codificada do campo é usado na seqüência de caracteres de formato personalizado. Por padrão, a seqüência de caracteres de formatação é aplicada aos valores do campo somente quando o controle ligado a dados está no modo somente leitura. Para aplicar a seqüência de caracteres de formatação para os valores exibidos enquanto o controle ligado a dados está no modo de edição, defina a ApplyFormatInEditMode propriedade para true. Se o valor de um campo for null, você pode exibir uma legenda personalizada, definindo a NullDisplayText propriedade. O BoundField objeto também automaticamente pode converter a seqüência de caracteres vazia ("") valores nulos e de campo, definindo a ConvertEmptyStringToNull propriedade para true.

Você pode ocultar um BoundField objeto em um controle ligado a dados, definindo a Visible propriedade para false. Para impedir que o valor de um campo que está sendo modificado em modo de edição, defina a ReadOnly propriedade para true. Na data-bound controles que suportam que inserindo registros (como o DetailsView controle), você pode ocultar um BoundField objeto, definindo a InsertVisible propriedade para false. Normalmente, isso é 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 o HeaderText ou FooterText 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 oculto na BoundField o objeto, definindo a ShowHeader propriedade para false.

ObservaçãoObservação

Alguns controles ligados a dados (como o GridView control) podem mostrar ou ocultar somente a seção inteira de cabeçalho do controle. Esses controles ligados a dados não oferecem suporte a ShowHeader propriedade para um campo acoplado individual. Para mostrar ou ocultar a seção de cabeçalho inteira de um controle ligado a dados (se disponível), use o controle ShowHeader propriedade.

Você também pode personalizar a aparência da BoundField objeto (cor da fonte, cor de plano 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 diferente.

Propriedade de estilo

Descrição

ControlStyle

As configurações de estilo para os controles de servidor Web filho da BoundField objeto.

FooterStyle

As configurações de estilo para a seção de rodapé a BoundField objeto.

HeaderStyle

As configurações de estilo para a seção de cabeçalho da BoundField objeto.

ItemStyle

As configurações de estilo para os itens de dados na BoundField objeto.

O exemplo de código a seguir demonstra como usar um BoundField o 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>



.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft