FormView.EmptyDataTemplate 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 den benutzerdefinierten Inhalt für die leere Datenzeile ab, die gerendert wird, wenn ein FormView-Steuerelement an eine Datenquelle ohne Datensätze gebunden ist, oder legt diesen Inhalt fest.
public:
virtual property System::Web::UI::ITemplate ^ EmptyDataTemplate { System::Web::UI::ITemplate ^ get(); void set(System::Web::UI::ITemplate ^ value); };[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.FormView))]
public virtual System.Web.UI.ITemplate EmptyDataTemplate { get; set; }[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.FormView))>]
member this.EmptyDataTemplate : System.Web.UI.ITemplate with get, setPublic Overridable Property EmptyDataTemplate As ITemplateEigenschaftswert
Eine ITemplate, die den benutzerdefinierten Inhalt für die leere Datenzeile enthält. Der Standardwert ist null und gibt an, dass diese Eigenschaft nicht festgelegt ist.
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie eine benutzerdefinierte Vorlage für die leere Datenzeile definiert wird, die angezeigt wird, wenn ein FormView Steuerelement an eine Datenquelle gebunden ist, die keine Datensätze enthält.
<%@ Page language="C#" %>
<!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" >
<head runat="server">
<title>FormView EmptyDataTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView EmptyDataTemplate Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<EmptyDataRowStyle BackColor="Red"
height="100"/>
<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>
<emptydatatemplate>
<table>
<tr>
<td>
<asp:image id="NoDataImage"
imageurl="~/Images/NoDataImage.jpg"
alternatetext="No image"
runat="server"/>
</td>
<td>
No records available.
</td>
</tr>
</table>
</emptydatatemplate>
<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. -->
<!-- The select query for the following SqlDataSource -->
<!-- control is intentionally set to return no results -->
<!-- to demonstrate the empty data row. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees] Where [EmployeeID]=1000"
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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView EmptyDataTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView EmptyDataTemplate Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<EmptyDataRowStyle BackColor="Red"
height="100"/>
<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>
<emptydatatemplate>
<table>
<tr>
<td>
<asp:image id="NoDataImage"
imageurl="~/Images/NoDataImage.jpg"
alternatetext="No image"
runat="server"/>
</td>
<td>
No records available.
</td>
</tr>
</table>
</emptydatatemplate>
<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. -->
<!-- The select query for the following SqlDataSource -->
<!-- control is intentionally set to return no results -->
<!-- to demonstrate the empty data row. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees] Where [EmployeeID]=1000"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Hinweise
Die leere Datenzeile wird in einem FormView Steuerelement angezeigt, wenn die Datenquelle, die an das Steuerelement gebunden ist, keine Datensätze enthält. Sie können Ihre eigene benutzerdefinierte Benutzeroberfläche (UI) für die leere Datenzeile definieren, indem Sie die EmptyDataTemplate -Eigenschaft verwenden. Um eine benutzerdefinierte Vorlage für die leere Datenzeile anzugeben, platzieren Sie <EmptyDataTemplate> Tags zuerst zwischen den öffnenden und schließenden Tags des FormView Steuerelements. Anschließend können Sie den Inhalt der Vorlage zwischen den öffnenden und schließenden <EmptyDataTemplate> Tags auflisten. Verwenden Sie EmptyDataRowStyle die -Eigenschaft, um den Stil der leeren Datenzeile zu steuern. Alternativ können Sie die integrierte Benutzeroberfläche für die leere Datenzeile verwenden, indem Sie anstelle dieser Eigenschaft die EmptyDataText -Eigenschaft festlegen.
Hinweis
Wenn sowohl die EmptyDataText -Eigenschaft als EmptyDataTemplate auch die -Eigenschaft festgelegt sind, hat die EmptyDataTemplate -Eigenschaft Vorrang.
