DetailsView.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.
Dient zum Abrufen oder Festlegen des benutzerdefinierten Inhalts für die leere Datenzeile, die gerendert wird, wenn ein DetailsView Steuerelement an eine Datenquelle gebunden ist, die keine Datensätze enthält.
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.DetailsView))]
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.DetailsView))>]
member this.EmptyDataTemplate : System.Web.UI.ITemplate with get, setPublic Overridable Property EmptyDataTemplate As ITemplateEigenschaftswert
Ein ITemplate Objekt, das den benutzerdefinierten Inhalt für die leere Datenzeile enthält. Der Standardwert ist null, der angibt, dass diese Eigenschaft nicht festgelegt ist.
- Attribute
Beispiele
Im folgenden Codebeispiel wird die Verwendung der EmptyDataTemplate Eigenschaft zum Erstellen einer benutzerdefinierten leeren Datenzeile veranschaulicht.
<%@ 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>DetailsView EmptyDataTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsView EmptyDataTemplate Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="StoresDetailsSqlDataSource"
autogeneraterows="true"
EmptyDataText="No records."
runat="server">
<emptydatarowstyle backcolor="Navy"
forecolor="Red"/>
<emptydatatemplate>
<table width="100%">
<tr>
<td>
<asp:Image id="NoRecordsImage"
AlternateText='No records'
imageurl="~\images\NoRecords.jpg"
runat="server"/>
</td>
<td>
<asp:Label id="NoRecordsMessageLabel"
forecolor="Red"
text="No Records."
runat="server"/>
</td>
</tr>
</table>
</emptydatatemplate>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<!-- The select query of the following SqlDataSource -->
<!-- control has been intentionally set to return no -->
<!-- results to demonstrate the empty data row. -->
<asp:sqldatasource id="StoresDetailsSqlDataSource"
selectcommand="SELECT [stor_id], [stor_name], [stor_address], [city], [state], [zip] FROM [stores] WHERE [state]='FL'"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView EmptyDataTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsView EmptyDataTemplate Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="StoresDetailsSqlDataSource"
autogeneraterows="true"
EmptyDataText="No records."
runat="server">
<emptydatarowstyle backcolor="Navy"
forecolor="Red"/>
<emptydatatemplate>
<table width="100%">
<tr>
<td>
<asp:Image id="NoRecordsImage"
AlternateText='No Records'
imageurl="~\images\NoRecords.jpg"
runat="server"/>
</td>
<td>
<asp:Label id="NoRecordsMessageLabel"
forecolor="Red"
text="No records."
runat="server"/>
</td>
</tr>
</table>
</emptydatatemplate>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<!-- The select query of the following SqlDataSource -->
<!-- control has been intentionally set to return no -->
<!-- results to demonstrate the empty data row. -->
<asp:sqldatasource id="StoresDetailsSqlDataSource"
selectcommand="SELECT [stor_id], [stor_name], [stor_address], [city], [state], [zip] FROM [stores] WHERE [state]='FL'"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Hinweise
Die leere Datenzeile wird in einem DetailsView 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 mithilfe der EmptyDataTemplate Eigenschaft definieren. Wenn Sie eine benutzerdefinierte Vorlage für die Nullzeile angeben möchten, platzieren <EmptyDataTemplate> Sie zunächst Tags zwischen den öffnenden und schließenden Tags des DetailsView Steuerelements. Anschließend können Sie den Inhalt der Vorlage zwischen den öffnenden und schließenden <EmptyDataTemplate> Tags auflisten. Verwenden Sie die EmptyDataRowStyle Eigenschaft, um die Formatvorlage der leeren Datenzeile zu steuern. Alternativ können Sie die integrierte Benutzeroberfläche für die leere Datenzeile verwenden, indem Sie die EmptyDataText Eigenschaft anstelle dieser Eigenschaft festlegen.
Hinweis
Wenn sowohl die Eigenschaften EmptyDataTemplate als auch die EmptyDataText Eigenschaften festgelegt sind, hat die EmptyDataTemplate Eigenschaft Vorrang.
