DataGridColumn.FooterText (Propiedad)
.NET Framework 3.5
Actualización: noviembre 2007
Obtiene o establece el texto que se muestra en la sección de pie de página de la columna.
Ensamblado: System.Web (en System.Web.dll)
/** @property */ public String get_FooterText() /** @property */ public void set_FooterText(String value)
public function get FooterText () : String public function set FooterText (value : String)
Valor de propiedad
Tipo: System.StringTexto que se muestra en la sección de pie de página de la columna. El valor predeterminado es String.Empty.
Utilice la propiedad FooterText para especificar o determinar el texto que se muestra en la sección de pie de página de la columna.
 Precaución: |
|---|
El texto no tiene la codificación HTML antes de mostrarse en la sección de pie de página de la columna. De esta forma se pueden incrustar secuencias de comandos en las etiquetas HTML del texto. Si los valores para esta propiedad se establecen de forma dinámica mediante la entrada de datos del usuario, asegúrese de que los valida para reducir los puntos vulnerables de seguridad. |
En el ejemplo de código siguiente se indica cómo usar la propiedad FooterText para especificar el texto que se muestra en la sección de pie de página de la columna.
<%@ 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 runat="server"> ICollection CreateDataSource() { // Create sample data for the DataGrid control. DataTable dt = new DataTable(); DataRow dr; // Define the columns of the table. dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(string))); dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double))); dt.Columns.Add(new DataColumn("BooleanValue", typeof(bool))); // Populate the table with sample values. for (int i = 0; i < 5; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Item " + i.ToString(); dr[2] = 1.23 * (i + 1); dr[3] = false; dt.Rows.Add(dr); } // To persist the data source between posts to the server, store // it in session state. Session["Source"] = dt; DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs e) { // Load sample data only once, when the page is first loaded. if (!IsPostBack) { // Make sure to set the header text before binding the data to // the DataGrid control; otherwise, the change will not appear // until the next time the page is refreshed. ItemsGrid.Columns[0].HeaderText = "Item"; ItemsGrid.DataSource = CreateDataSource(); ItemsGrid.DataBind(); } } void Button_Click(Object sender, EventArgs e) { double subtotal = 0.0; // Update the data source with the user's selection and // calculate the subtotal. DataTable dt = UpdateSource(ref subtotal); // Display the subtotal in the footer section of the third column. ItemsGrid.Columns[2].FooterText = "Subtotal: " + subtotal.ToString("c"); // Create a DataView and bind it to the DataGrid control. DataView dv = new DataView(dt); ItemsGrid.DataSource = dv; ItemsGrid.DataBind(); } DataTable UpdateSource(ref double subtotal) { // Retrieve the data table from session state. DataTable dt = (DataTable)Session["Source"]; // Iterate through the Items collection and update the data source // with the user's selections. If an item is selected, add the // amount of the item to the subtotal. foreach (DataGridItem item in ItemsGrid.Items) { // Retrieve the SelectCheckBox CheckBox control from the // specified item (row) in the DataGrid control. CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox"); if (selection != null) { // Update the BooleanValue field with the value of the check box. dt.Rows[item.ItemIndex][3] = selection.Checked; // Add the value of the item to the subtotal if the item is // selected. if (selection.Checked) { subtotal += Convert.ToDouble(item.Cells[2].Text.Substring(1)); } } } // Save the data source. Session["Source"] = dt; return dt; } </script> <head runat="server"> <title>DataGridColumn HeaderText and FooterText Example</title> </head> <body> <form id="form1" runat="server"> <h3>DataGridColumn HeaderText and FooterText Example</h3> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" ShowFooter="True" AutoGenerateColumns="False" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <FooterStyle BackColor="#00aaaa"> </FooterStyle> <Columns> <asp:BoundColumn DataField="IntegerValue"/> <asp:BoundColumn DataField="StringValue" HeaderText="Description"/> <asp:BoundColumn DataField="CurrencyValue" HeaderText="Price" DataFormatString="{0:c}"> <ItemStyle HorizontalAlign="Right"> </ItemStyle> </asp:BoundColumn> <asp:TemplateColumn HeaderText="Select Item"> <ItemTemplate> <asp:CheckBox id="SelectCheckBox" Text="Add to Cart" Checked='<%# DataBinder.Eval(Container.DataItem, "BooleanValue") %>' runat="server"/> </ItemTemplate> </asp:TemplateColumn> </Columns> </asp:DataGrid> <br /><br /> <asp:Button id="SubmitButton" Text="Submit" OnClick = "Button_Click" runat="server"/> </form> </body> </html>
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
