BoundColumn Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Tipo de columna del control DataGrid que está enlazado a un campo de un origen de datos.

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

Herencia: Object

DataGridColumn
BoundColumn

Ejemplos

En el ejemplo siguiente se muestra cómo usar un BoundColumn tipo de columna en el DataGrid control para mostrar los campos de un origen de datos.

<%@ 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>

Comentarios

Use el BoundColumn tipo de columna en un DataGrid control para mostrar el contenido de un campo en el origen de datos. Los valores se muestran en una sola columna. El campo está vinculado a BoundColumn, por lo que las actualizaciones del origen de datos se reflejarán en las celdas correspondientes del DataGrid control.

Nota:

Este tipo de columna es el valor predeterminado para el DataGrid control .

Para controlar la apariencia de esta columna, use las propiedades de estilo del DataGrid control .

Precaución

El texto no está codificado en HTML antes de que se muestre en BoundColumn. Esto permite insertar script dentro de etiquetas HTML en el texto. Si los valores de esta columna proceden de la entrada del usuario, asegúrese de validar los valores para reducir las vulnerabilidades de seguridad.

Constructores

BoundColumn()

Inicializa una nueva instancia de la clase BoundColumn.

Campos

thisExpr

Representa la cadena "!". Este campo es de solo lectura.

Propiedades

DataField	Obtiene o establece el nombre de campo del origen de datos que se va a enlazar al objeto BoundColumn.
DataFormatString	Obtiene o establece la cadena que especifica el formato de presentación de los elementos en la columna.
DesignMode	Obtiene un valor que indica si la columna está en modo de diseño. (Heredado de DataGridColumn)
FooterStyle	Obtiene las propiedades de estilo de la sección de pie de página de la columna. (Heredado de DataGridColumn)
FooterText	Obtiene o establece el texto que se muestra en la sección de pie de página de la columna. (Heredado de DataGridColumn)
HeaderImageUrl	Obtiene o establece la ubicación de una imagen que se va a mostrar en la sección de encabezado de la columna. (Heredado de DataGridColumn)
HeaderStyle	Obtiene las propiedades de estilo de la sección de encabezado de la columna. (Heredado de DataGridColumn)
HeaderText	Obtiene o establece el texto que se muestra en la sección de encabezado de la columna. (Heredado de DataGridColumn)
IsTrackingViewState	Obtiene un valor que determina si el objeto DataGridColumn se marca para que guarde su estado. (Heredado de DataGridColumn)
ItemStyle	Obtiene las propiedades de estilo de las celdas de elemento de la columna. (Heredado de DataGridColumn)
Owner	Obtiene el control DataGrid del que forma parte la columna. (Heredado de DataGridColumn)
ReadOnly	Obtiene o establece un valor que indica si los elementos del objeto BoundColumn pueden modificarse.
SortExpression	Obtiene o establece el nombre del campo o expresión que se va a pasar al método OnSortCommand(DataGridSortCommandEventArgs) cuando se selecciona una columna para ordenarla. (Heredado de DataGridColumn)
ViewState	Obtiene el objeto StateBag, que permite a una columna derivada de la clase DataGridColumn almacenar sus propiedades. (Heredado de DataGridColumn)
Visible	Obtiene o establece un valor que indica si se muestra la columna en el control DataGrid. (Heredado de DataGridColumn)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FormatDataValue(Object)	Convierte el valor especificado al formato indicado por la propiedad DataFormatString.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Initialize()	Restablece el estado inicial de BoundColumn.
InitializeCell(TableCell, Int32, ListItemType)	Restablece el estado inicial de la celda especificada en el objeto BoundColumn.
LoadViewState(Object)	Carga el estado del objeto DataGridColumn. (Heredado de DataGridColumn)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnColumnChanged()	Llama al método OnColumnsChanged(). (Heredado de DataGridColumn)
SaveViewState()	Guarda el estado actual del objeto DataGridColumn. (Heredado de DataGridColumn)
ToString()	Devuelve la representación de cadena de la columna. (Heredado de DataGridColumn)
TrackViewState()	Origina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor. (Heredado de DataGridColumn)

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState	Obtiene un valor que indica si la columna está efectuando un seguimiento de los cambios del estado de vista. (Heredado de DataGridColumn)
IStateManager.LoadViewState(Object)	Carga el estado guardado anteriormente. (Heredado de DataGridColumn)
IStateManager.SaveViewState()	Devuelve un objeto que contiene los cambios de estado. (Heredado de DataGridColumn)
IStateManager.TrackViewState()	Inicia el seguimiento de los cambios de estado. (Heredado de DataGridColumn)

Se aplica a

Compartir vía