ListView.EmptyItemTemplate 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定空白項目的使用者定義內容,當目前資料頁的最後一筆資料列已沒有可顯示的資料項目時,ListView 控制項中會呈現該空白項目。
public:
virtual property System::Web::UI::ITemplate ^ EmptyItemTemplate { 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.ListViewItem))]
public virtual System.Web.UI.ITemplate EmptyItemTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ListViewItem))>]
member this.EmptyItemTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property EmptyItemTemplate As ITemplate
屬性值
物件,包含空白項目的自訂內容。 預設值為 null
,表示這個屬性尚未設定。
- 屬性
範例
下列範例示範如何定義空白專案的自定義範本。
<%@ 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 id="Head1" runat="server">
<title>ListView EmptyItemTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView EmptyItemTemplate Example</h3>
<asp:ListView ID="ContactsListView"
DataSourceID="ContactsDataSource"
GroupItemCount="4"
runat="server">
<LayoutTemplate>
<table runat="server" id="tblProducts">
<tr runat="server" id="groupPlaceholder" />
</table>
</LayoutTemplate>
<GroupTemplate>
<tr runat="server" id="ProductsRow" align="center">
<td runat="server" id="itemPlaceholder" />
</tr>
</GroupTemplate>
<ItemTemplate>
<td runat="server">
<asp:Label ID="FirstNameLabel" runat="Server" Text='<%#Eval("FirstName") %>' /><br />
<asp:Label ID="LastNameLabel" runat="Server" Text='<%#Eval("LastName") %>' />
</td>
</ItemTemplate>
<ItemSeparatorTemplate>
<td runat="server" style="border-right: 1px solid #ccc"> </td>
</ItemSeparatorTemplate>
<GroupSeparatorTemplate>
<tr runat="server">
<td colspan="7"><hr /></td>
</tr>
</GroupSeparatorTemplate>
<EmptyItemTemplate>
<td runat="server">***</td>
</EmptyItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks 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 less results -->
<!-- to demonstrate the empty item template -->
<asp:SqlDataSource ID="ContactsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [ContactID], [FirstName], [LastName]
FROM Person.Contact
WHERE [ContactID]<10">
</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 id="Head1" runat="server">
<title>ListView EmptyItemTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView EmptyItemTemplate Example</h3>
<asp:ListView ID="ContactsListView"
DataSourceID="ContactsDataSource"
GroupItemCount="4"
runat="server">
<LayoutTemplate>
<table runat="server" id="tblProducts">
<tr runat="server" id="groupPlaceholder" />
</table>
</LayoutTemplate>
<GroupTemplate>
<tr runat="server" id="ProductsRow" align="center">
<td runat="server" id="itemPlaceholder" />
</tr>
</GroupTemplate>
<ItemTemplate>
<td runat="server">
<asp:Label ID="FirstNameLabel" runat="Server" Text='<%#Eval("FirstName") %>' /><br />
<asp:Label ID="LastNameLabel" runat="Server" Text='<%#Eval("LastName") %>' />
</td>
</ItemTemplate>
<ItemSeparatorTemplate>
<td runat="server" style="border-right: 1px solid #ccc"> </td>
</ItemSeparatorTemplate>
<GroupSeparatorTemplate>
<tr runat="server">
<td colspan="7"><hr /></td>
</tr>
</GroupSeparatorTemplate>
<EmptyItemTemplate>
<td runat="server">***</td>
</EmptyItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks 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 less results -->
<!-- to demonstrate the empty item template -->
<asp:SqlDataSource ID="ContactsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [ContactID], [FirstName], [LastName]
FROM Person.Contact
WHERE [ContactID]<10">
</asp:SqlDataSource>
</form>
</body>
</html>
備註
當目前頁面的最後一 ListView 個群組中沒有其他要顯示的數據項時,空白項目會顯示在控件中。 只有當 設定為大於 1 的值時 GroupItemCount ,才會發生此情況。 例如,在控件中 ListView ,屬性可能會設定為5, GroupItemCount 而從數據源傳回的專案總數為8。 在此情況下,最後一個數據列會包含範本所 ItemTemplate 定義的三個專案,以及範本所 EmptyItemTemplate 定義的兩個專案。
您可以使用 屬性,為空專案 EmptyItemTemplate 定義自定義使用者介面 (UI) 。 若要以宣告方式為空白專案指定自定義範本,請在控件內ListView新增 EmptyItemTemplate
專案。 然後,您可以將範本的內容新增至 EmptyItemTemplate
元素。