FormView.FooterRow Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das FormViewRow Objekt ab, das die Fußzeile in einem FormView Steuerelement darstellt.
public:
virtual property System::Web::UI::WebControls::FormViewRow ^ FooterRow { System::Web::UI::WebControls::FormViewRow ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.FormViewRow FooterRow { get; }
[<System.ComponentModel.Browsable(false)>]
member this.FooterRow : System.Web.UI.WebControls.FormViewRow
Public Overridable ReadOnly Property FooterRow As FormViewRow
Eigenschaftswert
Ein FormViewRow Wert, der die Fußzeile in einem FormView Steuerelement darstellt.
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die FooterRow Eigenschaft zum programmgesteuerten Ändern der Eigenschaften der Fußzeile während des ItemCreated Ereignisses verwendet wird.
<%@ 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">
void EmployeeFormView_ItemCreated(Object sender, EventArgs e)
{
// Use the FooterRow property to retrieve the footer row.
FormViewRow footer = EmployeeFormView.FooterRow;
// Retrieve the FooterLabel Label control from the footer row.
Label footerLabel = (Label)footer.FindControl("FooterLabel");
if(footerLabel != null)
{
// Display the current page number.
int currentPage = EmployeeFormView.PageIndex + 1;
footerLabel.Text = "Page " + currentPage.ToString();
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView FooterTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView FooterTemplate Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
onitemcreated="EmployeeFormView_ItemCreated"
runat="server">
<footertemplate>
<table>
<tr>
<td>
<asp:image id="LogoImage"
imageurl="~/Images/LogoImage.jpg"
alternatetext="Our Logo"
runat="server"/>
</td>
<td>
<asp:label id="FooterLabel"
runat="server"/>
</td>
</tr>
</table>
</footertemplate>
<footerstyle horizontalalign="Center"
forecolor="White"
backcolor="LightBlue"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
<pagersettings position="Bottom"
mode="NextPrevious"/>
</asp:formview>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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">
Sub EmployeeFormView_ItemCreated(ByVal sender As Object, ByVal e As EventArgs)
' Use the FooterRow property to retrieve the footer row.
Dim footer As FormViewRow = EmployeeFormView.FooterRow
' Retrieve the FooterLabel Label control from the footer row.
Dim footerLabel As Label = CType(footer.FindControl("FooterLabel"), Label)
If footerLabel IsNot Nothing Then
' Display the current page number.
Dim currentPage As Integer = EmployeeFormView.PageIndex + 1
footerLabel.Text = "Page " & currentPage.ToString()
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView FooterTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView FooterTemplate Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
onitemcreated="EmployeeFormView_ItemCreated"
runat="server">
<footertemplate>
<table>
<tr>
<td>
<asp:image id="LogoImage"
imageurl="~/Images/LogoImage.jpg"
alternatetext="Our Logo"
runat="server"/>
</td>
<td>
<asp:label id="FooterLabel"
runat="server"/>
</td>
</tr>
</table>
</footertemplate>
<footerstyle horizontalalign="Center"
forecolor="White"
backcolor="LightBlue"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
<pagersettings position="Bottom"
mode="NextPrevious"/>
</asp:formview>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Hinweise
Die Fußzeile wird am unteren Rand des FormView Steuerelements angezeigt, wenn die FooterText Eigenschaft FooterTemplate festgelegt ist. Verwenden Sie die FooterRow Eigenschaft, um programmgesteuert auf das FormViewRow Objekt zuzugreifen, das die Fußzeile darstellt.
Hinweis
Die FooterRow Eigenschaft ist erst verfügbar, nachdem das FormView Steuerelement die Fußzeile im ItemCreated Ereignis erstellt hat.
Diese Eigenschaft wird häufig verwendet, wenn Sie die Fußzeile programmgesteuert bearbeiten müssen, z. B. beim Hinzufügen von benutzerdefiniertem Inhalt. Jede Änderung der FooterRow Eigenschaft muss ausgeführt werden, nachdem das FormView Steuerelement gerendert wurde. Andernfalls überschreibt das FormView Steuerelement alle Änderungen.
Verwenden Sie die FooterStyle Eigenschaft, um die Formatvorlage der Fußzeile zu steuern.