DetailsView.EmptyDataTemplate Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger det användardefinierade innehållet för den tomma dataraden som återges när en DetailsView kontroll är bunden till en datakälla som inte innehåller några poster.
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, set
Public Overridable Property EmptyDataTemplate As ITemplate
Egenskapsvärde
En ITemplate som innehåller det anpassade innehållet för den tomma dataraden. Standardvärdet är null, vilket anger att den här egenskapen inte har angetts.
- Attribut
Exempel
Följande kodexempel visar hur du använder EmptyDataTemplate egenskapen för att skapa en anpassad tom datarad.
<%@ 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>
Kommentarer
Den tomma dataraden visas i en DetailsView kontroll när datakällan som är bunden till kontrollen inte innehåller några poster. Du kan definiera ditt eget anpassade användargränssnitt (UI) för den tomma dataraden EmptyDataTemplate med hjälp av egenskapen . Om du vill ange en anpassad mall för null-raden placerar du taggarna för första plats <EmptyDataTemplate> mellan kontrollens DetailsView inledande och avslutande taggar. Du kan sedan visa en lista över innehållet i mallen mellan de inledande och avslutande <EmptyDataTemplate> taggarna. Om du vill styra formatmallen för den tomma dataraden använder du EmptyDataRowStyle egenskapen . Du kan också använda det inbyggda användargränssnittet för den tomma dataraden EmptyDataText genom att ange egenskapen i stället för den här egenskapen.
Note
Om både EmptyDataText egenskaperna och EmptyDataTemplate anges har egenskapen EmptyDataTemplate företräde.