BoundColumn Clase
Definición
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
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) |