GridView.EmptyDataRowStyle プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文null 行の外観を設定できるようにする TableItemStyle への参照。
解説EmptyDataRowStyle プロパティを使用して、GridView コントロールの null 行の外観を制御します。null 行は、コントロールにバインドされているデータ ソースにレコードが格納されていない場合に表示されます。このプロパティは読み取り専用です。ただし、このプロパティが返す TableItemStyle オブジェクトのプロパティを設定することはできます。次のいずれかの方法を使用することにより、プロパティを宣言によって設定できます。
-
GridView コントロールの開始タグに、Property-Subproperty の形式で属性を指定します。ここで、Subproperty には、TableItemStyle オブジェクトのプロパティを指定します (例 : EmptyDataRowStyle-ForeColor)。
-
GridView コントロールの開始タグと終了タグの間で <EmptyDataRowStyle> 要素を入れ子にします。
Property.Subproperty の形式で、プロパティをプログラムによって設定することもできます (例 : EmptyDataRowStyle.ForeColor)。通常、共通設定には、カスタムの背景色、前景色、およびフォントのプロパティが含まれます。
使用例EmptyDataRowStyle プロパティを宣言によって設定して、null 行に薄青色の背景と赤のフォントを指定する方法を次のコード例に示します。
<%@ 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.EmptyDataRowStyle プロパティのページへのリンク
