DetailsView.FooterRow Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un oggetto DetailsViewRow che rappresenta la riga del piè di pagina in un controllo DetailsView.
public:
virtual property System::Web::UI::WebControls::DetailsViewRow ^ FooterRow { System::Web::UI::WebControls::DetailsViewRow ^ get(); };[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.DetailsViewRow FooterRow { get; }[<System.ComponentModel.Browsable(false)>]
member this.FooterRow : System.Web.UI.WebControls.DetailsViewRowPublic Overridable ReadOnly Property FooterRow As DetailsViewRowValore della proprietà
Un oggetto DetailsViewRow che rappresenta la riga del piè di pagina in un controllo DetailsView.
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare la FooterRow proprietà per accedere alla riga del piè di pagina del DetailsView controllo durante l'evento ItemCreated . Un Label controllo all'interno della riga del piè di pagina personalizzata viene quindi aggiornato con il numero di pagina corrente.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void CustomerDetailView_DataBound(object sender,
EventArgs e)
{
// Get the footer row.
DetailsViewRow footerRow = CustomerDetailView.FooterRow;
// Get the Label control that displays the current page
// information from the footer row.
Label pageNum =
(Label)footerRow.Cells[0].FindControl("PageNumberLabel");
if (pageNum != null)
{
// Update the Label control with the current page number.
int page = CustomerDetailView.DataItemIndex + 1;
pageNum.Text = "Page " + page.ToString();
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView FooterTemplate Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView FooterTemplate Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogeneraterows="true"
allowpaging="true"
runat="server"
OnDataBound="CustomerDetailView_DataBound">
<headerstyle backcolor="Navy"
forecolor="White"/>
<pagersettings Mode="NextPreviousFirstLast"/>
<FooterTemplate>
<table width="100%">
<tr>
<td align="left">
<asp:Image id="LogoImage"
AlternateText="Our logo"
imageurl="~\images\Logo.jpg"
runat="server"/>
</td>
<td align="right" valign="bottom">
<asp:Label id="PageNumberLabel"
font-size="9"
forecolor="DodgerBlue"
runat="server"/>
</td>
</tr>
</table>
</FooterTemplate>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the web.config file. -->
<asp:SqlDataSource ID="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country] From
[Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub CustomerDetailView_DataBound(ByVal sender As Object, _
ByVal e As EventArgs)
' Get the footer row.
Dim footerRow As DetailsViewRow = CustomerDetailView.FooterRow
' Get the Label control that displays the current page
' information from the footer row.
Dim pageNum As Label = _
CType(footerRow.Cells(0).FindControl("PageNumberLabel"), Label)
If pageNum IsNot Nothing Then
' Update the Label control with the current page number.
Dim page As Integer = CustomerDetailView.DataItemIndex + 1
pageNum.Text = "Page " + page.ToString()
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView FooterTemplate Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView FooterTemplate Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogeneraterows="true"
allowpaging="true"
runat="server"
OnDataBound="CustomerDetailView_DataBound">
<headerstyle backcolor="Navy"
forecolor="White"/>
<pagersettings Mode="NextPreviousFirstLast"/>
<FooterTemplate>
<table width="100%">
<tr>
<td align="left">
<asp:Image id="LogoImage"
AlternateText="Our logo"
imageurl="~\images\Logo.jpg"
runat="server"/>
</td>
<td align="right" valign="bottom">
<asp:Label id="PageNumberLabel"
font-size="9"
forecolor="DodgerBlue"
runat="server"/>
</td>
</tr>
</table>
</FooterTemplate>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the web.config file. -->
<asp:SqlDataSource ID="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country] From
[Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
Commenti
La riga del piè di pagina viene visualizzata nella parte inferiore del DetailsView controllo quando viene impostata la FooterText proprietà o FooterTemplate . Utilizzare la FooterRow proprietà per accedere a livello di codice all'oggetto DetailsViewRow che rappresenta la riga del piè di pagina.
Nota
La FooterRow proprietà è disponibile solo dopo che il DetailsView controllo crea la riga del piè di pagina nell'evento ItemCreated .
Questa proprietà viene comunemente usata quando è necessario modificare a livello di codice la riga del piè di pagina, ad esempio quando si aggiunge contenuto personalizzato. Tutte le modifiche apportate alla FooterRow proprietà devono essere eseguite dopo il rendering del DetailsView controllo. In caso contrario, il DetailsView controllo sovrascriverà eventuali modifiche.
Per controllare lo stile della riga del piè di pagina, utilizzare la FooterStyle proprietà .
