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

Um tipo de coluna para o DataGrid controlo que está associado a um campo numa 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 seguinte demonstra como usar um BoundColumn tipo de coluna no DataGrid controlo para mostrar os campos numa 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>

Observações

Use o tipo de BoundColumn coluna num DataGrid controlo para mostrar o conteúdo de um campo na fonte de dados. Os valores estão listados numa única coluna. O campo está ligado ao BoundColumn, pelo que quaisquer atualizações na fonte de dados serão refletidas nas células correspondentes do DataGrid controlo.

Note

Este tipo de coluna é o padrão para o DataGrid controlo.

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

Caution

O texto não é codificado em HTML antes de ser exibido no BoundColumnarquivo . Isto torna possível incorporar scripts dentro de tags HTML no texto. Se os valores desta coluna proviverem da entrada do utilizador, certifique-se de validar os valores para reduzir vulnerabilidades de segurança.

Construtores

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

Campos

Name	Description
thisExpr	Representa a cadeia "!". Este campo é só de leitura.

Propriedades

Name	Description
DataField	Obtém ou define o nome do campo da fonte de dados para se ligar ao BoundColumn.
DataFormatString	Obtém ou define a cadeia que especifica o formato de exibição dos itens na coluna.
DesignMode	Recebe um valor que indica se a coluna está em modo de design. (Herdado de DataGridColumn)
FooterStyle	Obtém as propriedades de estilo para a secção de rodapé da coluna. (Herdado de DataGridColumn)
FooterText	Recebe ou define o texto apresentado na secção de rodapé da coluna. (Herdado de DataGridColumn)
HeaderImageUrl	Obtém ou define a localização de uma imagem para ser exibida na secção do cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderStyle	Obtém as propriedades de estilo para a secção do cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderText	Recebe ou define o texto apresentado na secção de cabeçalho da coluna. (Herdado de DataGridColumn)
IsTrackingViewState	Obtém um valor que determina se o DataGridColumn objeto está marcado para guardar o seu estado. (Herdado de DataGridColumn)
ItemStyle	Obtém as propriedades de estilo das células do item da coluna. (Herdado de DataGridColumn)
Owner	Obtém o DataGrid controlo do qual a coluna pertence. (Herdado de DataGridColumn)
ReadOnly	Obtém ou define um valor que indica se os itens no BoundColumn podem ser editados.
SortExpression	Recebe ou define o nome do campo ou expressão a passar ao OnSortCommand(DataGridSortCommandEventArgs) método quando uma coluna é selecionada para ordenação. (Herdado de DataGridColumn)
ViewState	Obtém o StateBag objeto que permite que uma coluna derivada da DataGridColumn classe armazene as suas propriedades. (Herdado de DataGridColumn)
Visible	Recebe ou define um valor que indica se a coluna é visível no DataGrid controlo. (Herdado de DataGridColumn)

Métodos

Name	Description
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 DataFormatString propriedade.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Initialize()	Reinicia o BoundColumn para o seu estado inicial.
InitializeCell(TableCell, Int32, ListItemType)	Reinicia a célula especificada no BoundColumn seu estado inicial.
LoadViewState(Object)	Carrega o estado do DataGridColumn objeto. (Herdado de DataGridColumn)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnColumnChanged()	Chama o método OnColumnsChanged(). (Herdado de DataGridColumn)
SaveViewState()	Guarda o estado atual do DataGridColumn objeto. (Herdado de DataGridColumn)
ToString()	Devolve a representação da cadeia da coluna. (Herdado de DataGridColumn)
TrackViewState()	Causa o rastreio das alterações de estado de visualização no controlo do servidor para que possam ser armazenadas no objeto do StateBag controlo do servidor. (Herdado de DataGridColumn)

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Recebe um valor que indica se a coluna está a acompanhar alterações no estado da vista. (Herdado de DataGridColumn)
IStateManager.LoadViewState(Object)	Carrega o estado previamente guardado. (Herdado de DataGridColumn)
IStateManager.SaveViewState()	Devolve um objeto contendo alterações de estado. (Herdado de DataGridColumn)
IStateManager.TrackViewState()	Começa a acompanhar as alterações de estado. (Herdado de DataGridColumn)

Aplica-se a

Ver também

Comentários

Esta página foi útil?