BoundField Classe
Definição
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 que é exibido como texto num controlo encadernado por dados.
public ref class BoundField : System::Web::UI::WebControls::DataControlFieldpublic class BoundField : System.Web.UI.WebControls.DataControlFieldtype BoundField = class
inherit DataControlFieldPublic Class BoundField
Inherits DataControlField- Herança
- Derivado
Exemplos
O exemplo de código seguinte demonstra como usar um BoundField objeto para mostrar os valores de um campo num GridView controlo.
<%@ 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>
Observações
A BoundField classe é usada por controlos encadernados por dados (como GridView e DetailsView) para mostrar o valor de um campo como texto. O BoundField objeto é apresentado de forma diferente consoante o controlo limitado por dados em que é utilizado. Por exemplo, o controlo GridView apresenta um BoundField objeto como uma coluna, enquanto o DetailsView controlo o apresenta como uma linha.
Para especificar o campo a mostrar num BoundField objeto, defina a DataField propriedade para o nome do campo. O valor do campo pode ser codificado em HTML antes de ser exibido, definindo a HtmlEncode propriedade para true. Pode aplicar uma cadeia de formatação personalizada ao valor do campo definindo a DataFormatString propriedade. Quando a HtmlEncode propriedade é true, o valor da cadeia codificada do campo é usado na cadeia de formato personalizada. Por defeito, a cadeia de formatação é aplicada aos valores do campo apenas quando o controlo limitado por dados está em modo apenas de leitura. Para aplicar a cadeia de formatação aos valores exibidos enquanto o controlo data-bound está em modo de edição, defina a ApplyFormatInEditMode propriedade para true. Se o valor de um campo for nulo, pode mostrar uma legenda personalizada definindo a NullDisplayText propriedade. O BoundField objeto também pode converter automaticamente valores de campos de string vazios ("") em valores nulos, definindo a ConvertEmptyStringToNull propriedade para true.
Pode esconder um BoundField objeto num controlo data-bound definindo a Visible propriedade 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 vinculados a dados que suportam a inserção de registos (como o DetailsView controlo), pode ocultar um BoundField objeto definindo a InsertVisible propriedade para false. Isto é comum quando se quer esconder um campo de chave gerado automaticamente no modo de inserção.
Podes personalizar as secções de cabeçalho e rodapé de um BoundField 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 BoundField 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 BoundField 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 BoundField objeto. |
| FooterStyle | As definições de estilo para a secção do rodapé do BoundField objeto. |
| HeaderStyle | As definições de estilo para a secção do cabeçalho do BoundField objeto. |
| ItemStyle | As definições de estilo para os itens de dados no BoundField objeto. |
Construtores
| Name | Description |
|---|---|
| BoundField() |
Inicializa uma nova instância da BoundField classe. |
Campos
| Name | Description |
|---|---|
| ThisExpression |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Representa a expressão "isto". |
Propriedades
| Name | Description |
|---|---|
| AccessibleHeaderText |
Recebe ou define texto que é renderizado como valor de |
| ApplyFormatInEditMode |
Recebe ou define um valor que indica se a cadeia de formatação especificada pela DataFormatString propriedade é aplicada aos valores do campo quando o controlo limitado por dados que contém o BoundField objeto está em modo de edição. |
| 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 |
Recebe ou define um valor que indica se os valores de cadeia vazios ("") 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 para se ligar ao BoundField objeto. |
| DataFormatString |
Obtém ou define a cadeia que especifica o formato de exibição para o valor do campo. |
| 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. |
| HtmlEncode |
Recebe ou define um valor que indica se os valores dos campos são codificados em HTML antes de serem exibidos num BoundField objeto. |
| HtmlEncodeFormatString |
Recebe ou define um valor que indica se o texto criado ao aplicar a DataFormatString propriedade ao BoundField valor deve ser codificado em HTML quando é 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 |
Recebe ou define a legenda exibida para um campo quando o valor do campo é nulo. |
| ReadOnly |
Recebe ou define um valor que indica se o valor do campo pode ser modificado em modo de edição. |
| 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 que indica se a codificação HTML é suportada por um BoundField objeto. |
| ValidateRequestMode |
Recebe ou define um valor que determina se o controlo valida ou não a entrada do cliente. |
| 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 BoundField para o objeto especificado DataControlField . |
| CreateField() |
Cria um objeto vazio BoundField . |
| 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 TableCell . |
| FormatDataValue(Object, Boolean) |
Formata o valor do campo especificado para uma célula no BoundField objeto. |
| GetDesignTimeValue() |
Recupera o valor usado para o valor de um campo ao renderizar o BoundField 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. |
| Initialize(Boolean, Control) |
Inicializa o objeto BoundField. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inicializa o objeto especificado TableCell para o estado da linha especificado. |
| InitializeDataCell(DataControlFieldCell, DataControlRowState) |
Inicializa o objeto especificado TableCell para o estado da linha especificado. |
| LoadViewState(Object) |
Restaura a informação de estado de visualização previamente armazenada para este campo. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnDataBindField(Object, EventArgs) |
Vincula o valor de um campo ao BoundField objeto. |
| OnFieldChanged() |
Eleva o |
| 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 BoundField 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) |