ListView.EmptyItemTemplate Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Geçerli veri sayfasının son satırında görüntülenecek başka veri öğesi olmadığında denetimde ListView işlenen boş öğe için kullanıcı tanımlı içeriği alır veya ayarlar.
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Özellik Değeri
Boş öğenin özel içeriğini içeren bir nesne. Varsayılan değer, nullbu özelliğin ayarlanmadığını gösteren değeridir.
- Öznitelikler
Örnekler
Aşağıdaki örnekte, boş öğe için özel bir şablonun nasıl tanımlanacağı gösterilmektedir.
<%@ 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>
Açıklamalar
Geçerli sayfanın son grubunda görüntülenecek veri öğesi kalmadığında boş öğe bir ListView denetimde görüntülenir. Bu yalnızca 1'den büyük bir değere ayarlanırsa GroupItemCount oluşabilir. Örneğin, bir ListView denetimde GroupItemCount özelliği 5 olarak ayarlanabilir ve veri kaynağından döndürülen toplam öğe sayısı 8'dir. Bu durumda, son veri satırı şablon tarafından tanımlanan üç öğeyi ve şablon tarafından ItemTemplate tanımlanan iki öğeyi EmptyItemTemplate içerir.
özelliğini kullanarak EmptyItemTemplate boş öğe için özel bir kullanıcı arabirimi (UI) tanımlayabilirsiniz. Boş öğe için bildirimli olarak özel bir şablon belirtmek için, denetimin ListView içine bir EmptyItemTemplate öğe ekleyin. Daha sonra şablonun EmptyItemTemplate içeriğini öğesine ekleyebilirsiniz.
