GridView.EmptyDataTemplate プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文<TemplateContainerAttribute(GetType(GridViewRow))> _ Public Overridable Property EmptyDataTemplate As ITemplate
Dim instance As GridView Dim value As ITemplate value = instance.EmptyDataTemplate instance.EmptyDataTemplate = value
[TemplateContainerAttribute(typeof(GridViewRow))] public virtual ITemplate EmptyDataTemplate { get; set; }
[TemplateContainerAttribute(typeof(GridViewRow))] public: virtual property ITemplate^ EmptyDataTemplate { ITemplate^ get (); void set (ITemplate^ value); }
/** @property */ public ITemplate get_EmptyDataTemplate () /** @property */ public void set_EmptyDataTemplate (ITemplate value)
public function get EmptyDataTemplate () : ITemplate public function set EmptyDataTemplate (value : ITemplate)
空のデータ行用のカスタム コンテンツを含んだ System.Web.UI.ITemplate。既定値は null 参照 (Visual Basic では Nothing) で、このプロパティが設定されていないことを示します。
解説コントロールにバインドされているデータ ソースにレコードが格納されていない場合、GridView コントロールに空のデータ行が表示されます。EmptyDataTemplate プロパティを使用して、空のデータ行用に独自のカスタム ユーザー インターフェイス (UI) を定義できます。空のデータ行用のカスタム テンプレートを指定するには、最初に <EmptyDataTemplate> タグを GridView コントロールの開始タグと終了タグの間に配置します。その後、<EmptyDataTemplate> の開始タグと終了タグの間に、テンプレートの内容のリストを記述できます。空のデータ行のスタイルを制御するには、EmptyDataRowStyle プロパティを使用します。また、このプロパティの代わりに EmptyDataText プロパティを設定して、空のデータ行用の組み込みの UI を使用することもできます。
.gif) メモ |
|---|
| EmptyDataText プロパティと EmptyDataTemplate プロパティの両方が設定されている場合は、EmptyDataTemplate プロパティが優先されます。 |
使用例レコードが格納されていないデータ ソースに GridView コントロールがバインドされている場合に表示される、空のデータ行用のカスタム テンプレートを定義する方法を次のコード例に示します。
<%@ Page language="VB" %> <html> <body> <form runat="server"> <h3>GridView EmptyDataTemplate Example</h3> <asp:gridview id="CustomersGridView" datasourceid="CustomersSqlDataSource" autogeneratecolumns="true" runat="server"> <emptydatarowstyle backcolor="LightBlue" forecolor="Red"/> <emptydatatemplate> <asp:image id="NoDataImage" imageurl="~/images/Image.jpg" runat="server"/> No Data Found. </emptydatatemplate> </asp:gridview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. The following query --> <!-- returns an empty data source to demonstrate the --> <!-- empty row. --> <asp:sqldatasource id="CustomersSqlDataSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers] Where CustomerID='NoID'" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"> </asp:sqldatasource> </form> </body> </html>
<%@ Page language="C#" %> <html> <body> <form runat="server"> <h3>GridView EmptyDataTemplate Example</h3> <asp:gridview id="CustomersGridView" datasourceid="CustomersSqlDataSource" autogeneratecolumns="true" runat="server"> <emptydatarowstyle backcolor="LightBlue" forecolor="Red"/> <emptydatatemplate> <asp:image id="NoDataImage" imageurl="~/images/Image.jpg" runat="server"/> No Data Found. </emptydatatemplate> </asp:gridview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. The following query --> <!-- returns an empty data source to demonstrate the --> <!-- empty row. --> <asp:sqldatasource id="CustomersSqlDataSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers] Where CustomerID='NoID'" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"> </asp:sqldatasource> </form> </body> </html>
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- GridView.EmptyDataTemplate プロパティのページへのリンク
