DataList.ShowHeader Propiedad
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í.
Obtiene o establece un valor que indica si se muestra la sección de encabezado del control DataList.
public:
virtual property bool ShowHeader { bool get(); void set(bool value); };[System.ComponentModel.Bindable(true)]
public virtual bool ShowHeader { get; set; }public virtual bool ShowHeader { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.ShowHeader : bool with get, setmember this.ShowHeader : bool with get, setPublic Overridable Property ShowHeader As BooleanValor de propiedad
Es true si se muestra el encabezado; en caso contrario, es false. El valor predeterminado es true; sin embargo, esta propiedad sólo se examina cuando la propiedad HeaderTemplate no es null.
- Atributos
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la ShowHeader propiedad para mostrar la sección de encabezado en el DataList control .
Nota:
En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de Web Forms, vea modelo de código de página ASP.NET Web Forms.
<%@ 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 DataList 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("ImageValue", typeof(String)));
// Populate the table with sample values.
for (int i = 0; i < 9; i++)
{
dr = dt.NewRow();
dr[0] = i;
dr[1] = "Description for item " + i.ToString();
dr[2] = 1.23 * (i + 1);
dr[3] = "Image" + i.ToString() + ".jpg";
dt.Rows.Add(dr);
}
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)
{
ItemsList.DataSource = CreateDataSource();
ItemsList.DataBind();
}
}
void Selection_Change(Object sender, EventArgs e)
{
// Set whether to display the header and footer sections
// of the DataList control.
ItemsList.ShowHeader = ShowHeaderCheckBox.Checked;
ItemsList.ShowFooter = ShowFooterCheckBox.Checked;
}
</script>
<head runat="server">
<title>DataList ShowHeader and ShowFooter Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataList ShowHeader and ShowFooter Example</h3>
Select whether to show or hide the header and footer sections.
<br /><br />
<asp:DataList id="ItemsList"
BorderColor="black"
CellPadding="5"
CellSpacing="5"
RepeatDirection="Vertical"
RepeatLayout="Table"
RepeatColumns="3"
ShowHeader="True"
ShowFooter="True"
runat="server">
<HeaderStyle BackColor="#aaaadd">
</HeaderStyle>
<FooterStyle BackColor="#aaaadd">
</FooterStyle>
<AlternatingItemStyle BackColor="Gainsboro">
</AlternatingItemStyle>
<HeaderTemplate>
List of items
</HeaderTemplate>
<FooterTemplate>
<asp:Image id="FooterImage"
GenerateEmptyAlternateText='true'
ImageUrl='FooterImage.jpg'
runat="server"/>
</FooterTemplate>
<ItemTemplate>
Description: <br />
<%# DataBinder.Eval(Container.DataItem, "StringValue") %>
<br />
Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>
<br />
<asp:Image id="ProductImage"
AlternateText='<%# DataBinder.Eval(Container.DataItem, "StringValue") %>'
ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
runat="server"/>
</ItemTemplate>
</asp:DataList>
<hr />
<table cellpadding="5">
<tr>
<td>
<asp:CheckBox id="ShowHeaderCheckBox"
Text="Show header section"
Checked="True"
AutoPostBack="True"
OnCheckedChanged="Selection_Change"
runat="server"/>
</td>
<td>
<asp:CheckBox id="ShowFooterCheckBox"
Text="Show footer section"
Checked="True"
AutoPostBack="True"
OnCheckedChanged="Selection_Change"
runat="server"/>
</td>
</tr>
</table>
</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 runat="server">
Function CreateDataSource() As ICollection
' Create sample data for the DataList control.
Dim dt As DataTable = New DataTable()
dim dr As DataRow
' Define the columns of the table.
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
dt.Columns.Add(New DataColumn("ImageValue", GetType(String)))
' Populate the table with sample values.
Dim i As Integer
For i = 0 To 8
dr = dt.NewRow()
dr(0) = i
dr(1) = "Description for item " & i.ToString()
dr(2) = 1.23 * (i + 1)
dr(3) = "Image" & i.ToString() & ".jpg"
dt.Rows.Add(dr)
Next i
Dim dv As DataView = New DataView(dt)
Return dv
End Function
Sub Page_Load(sender As Object, e As EventArgs)
' Load sample data only once, when the page is first loaded.
If Not IsPostBack Then
ItemsList.DataSource = CreateDataSource()
ItemsList.DataBind()
End If
End Sub
Sub Selection_Change(sender As Object, e As EventArgs)
' Set whether to display the header and footer sections
' of the DataList control.
ItemsList.ShowHeader = ShowHeaderCheckBox.Checked
ItemsList.ShowFooter = ShowFooterCheckBox.Checked
End Sub
</script>
<head runat="server">
<title>DataList ShowHeader and ShowFooter Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataList ShowHeader and ShowFooter Example</h3>
Select whether to show or hide the header and footer sections.
<br /><br />
<asp:DataList id="ItemsList"
BorderColor="black"
CellPadding="5"
CellSpacing="5"
RepeatDirection="Vertical"
RepeatLayout="Table"
RepeatColumns="3"
ShowHeader="True"
ShowFooter="True"
runat="server">
<HeaderStyle BackColor="#aaaadd">
</HeaderStyle>
<FooterStyle BackColor="#aaaadd">
</FooterStyle>
<AlternatingItemStyle BackColor="Gainsboro">
</AlternatingItemStyle>
<HeaderTemplate>
List of items
</HeaderTemplate>
<FooterTemplate>
<asp:Image id="FooterImage"
GenerateEmptyAlternateText='true'
ImageUrl='FooterImage.jpg'
runat="server"/>
</FooterTemplate>
<ItemTemplate>
Description: <br />
<%# DataBinder.Eval(Container.DataItem, "StringValue") %>
<br />
Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>
<br />
<asp:Image id="ProductImage"
AlternateText='<%# DataBinder.Eval(Container.DataItem, "StringValue") %>'
ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
runat="server"/>
</ItemTemplate>
</asp:DataList>
<hr />
<table cellpadding="5">
<tr>
<td>
<asp:CheckBox id="ShowHeaderCheckBox"
Text="Show header section"
Checked="True"
AutoPostBack="True"
OnCheckedChanged="Selection_Change"
runat="server"/>
</td>
<td>
<asp:CheckBox id="ShowFooterCheckBox"
Text="Show footer section"
Checked="True"
AutoPostBack="True"
OnCheckedChanged="Selection_Change"
runat="server"/>
</td>
</tr>
</table>
</form>
</body>
</html>
Comentarios
Utilice la ShowHeader propiedad para especificar si la sección de encabezado se muestra en el DataList control .
Puede controlar la apariencia de la sección de encabezado estableciendo la HeaderStyle propiedad . El contenido de la sección de encabezado se controla mediante la HeaderTemplate propiedad .
Se aplica a
Consulte también
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de