BoundColumn 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.

Um tipo de coluna do controle DataGrid associado a um campo em uma fonte de dados.

public ref class BoundColumn : System::Web::UI::WebControls::DataGridColumn

public class BoundColumn : System.Web.UI.WebControls.DataGridColumn

type BoundColumn = class
    inherit DataGridColumn

Public Class BoundColumn
Inherits DataGridColumn

Herança: Object

DataGridColumn
BoundColumn

Exemplos

O exemplo a seguir demonstra como usar um BoundColumn tipo de coluna no DataGrid controle para exibir os campos em uma fonte de dados.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="VB" runat="server">
    Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
   </script>
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

Comentários

Use o BoundColumn tipo de coluna em um DataGrid controle para exibir o conteúdo de um campo na fonte de dados. Os valores são listados em uma única coluna. O campo está vinculado ao BoundColumn, portanto, todas as atualizações na fonte de dados refletirão nas células correspondentes do DataGrid controle.

Observação

Esse tipo de coluna é o padrão para o DataGrid controle .

Para controlar a aparência dessa coluna, use as propriedades de estilo do DataGrid controle.

Cuidado

O texto não é codificado em HTML antes de ser exibido no BoundColumn. Isso possibilita inserir script em marcas HTML no texto. Se os valores dessa coluna forem provenientes da entrada do usuário, valide os valores para reduzir as vulnerabilidades de segurança.

Construtores

BoundColumn()

Inicializa uma nova instância da classe BoundColumn.

Campos

thisExpr

Representa a cadeia de caracteres "!". Este campo é somente leitura.

Propriedades

DataField	Obtém ou define o nome do campo da fonte de dados para associar a BoundColumn.
DataFormatString	Obtém ou define a cadeia de caracteres que especifica o formato de exibição de itens na coluna.
DesignMode	Obtém um valor que indica se a coluna está no modo de design. (Herdado de DataGridColumn)
FooterStyle	Obtém as propriedades de estilo da seção de rodapé da coluna. (Herdado de DataGridColumn)
FooterText	Obtém ou define o texto exibido na seção de rodapé da coluna. (Herdado de DataGridColumn)
HeaderImageUrl	Obtém ou define o local de uma imagem a ser exibida na seção de cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderStyle	Obtém as propriedades de estilo para a seção de cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderText	Obtém ou define o texto exibido na seção de cabeçalho da coluna. (Herdado de DataGridColumn)
IsTrackingViewState	Obtém um valor que determina se o objeto DataGridColumn está marcado para salvar seu estado. (Herdado de DataGridColumn)
ItemStyle	Obtém as propriedades de estilo para as células do item da coluna. (Herdado de DataGridColumn)
Owner	Obtém o controle DataGrid do qual a coluna é membro. (Herdado de DataGridColumn)
ReadOnly	Obtém ou define um valor que indica se os itens no BoundColumn podem ser editados.
SortExpression	Obtém ou define o nome do campo ou expressão a ser passado para o método OnSortCommand(DataGridSortCommandEventArgs) quando uma coluna for selecionada para classificação. (Herdado de DataGridColumn)
ViewState	Obtém o objeto StateBag que permite que uma coluna derivada da classe DataGridColumn armazene suas propriedades. (Herdado de DataGridColumn)
Visible	Obtém ou define um valor que indica se a coluna está visível no controle DataGrid. (Herdado de DataGridColumn)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FormatDataValue(Object)	Converte o valor especificado para o formato indicado pela propriedade DataFormatString.
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)
Initialize()	Redefine o BoundColumn para seu estado inicial.
InitializeCell(TableCell, Int32, ListItemType)	Redefine a célula especificada no BoundColumn para seu estado inicial.
LoadViewState(Object)	Carrega o estado do objeto DataGridColumn. (Herdado de DataGridColumn)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnColumnChanged()	Chama o método OnColumnsChanged(). (Herdado de DataGridColumn)
SaveViewState()	Salva o estado atual do objeto DataGridColumn. (Herdado de DataGridColumn)
ToString()	Retorna a representação de cadeia de caracteres da coluna. (Herdado de DataGridColumn)
TrackViewState()	Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor. (Herdado de DataGridColumn)

Implantações explícitas de interface

IStateManager.IsTrackingViewState	Obtém um valor que indica se a coluna está controlando suas alterações de estado de exibição. (Herdado de DataGridColumn)
IStateManager.LoadViewState(Object)	Carrega o estado salvo anteriormente. (Herdado de DataGridColumn)
IStateManager.SaveViewState()	Retorna um objeto que contém as alterações de estado. (Herdado de DataGridColumn)
IStateManager.TrackViewState()	Inicia o controle de alterações de estado. (Herdado de DataGridColumn)

Aplica-se a

Partilhar via