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, setPublic 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 、プロパティは GroupItemCount 5 に設定され、データ ソースから返される項目の合計数は 8 になります。 その場合、データの最後の行には、テンプレートによって定義された 3 つの項目と、テンプレートによって ItemTemplate 定義された 2 つの項目が EmptyItemTemplate 含まれます。
このプロパティを使用して、空の項目のカスタム ユーザー インターフェイス (UI) を EmptyItemTemplate 定義できます。 空の項目に対して宣言によってカスタム テンプレートを指定するには、コントロール内に EmptyItemTemplate 要素を ListView 追加します。 その後、テンプレートの内容を要素に EmptyItemTemplate 追加できます。