Export (0) Print
Expand All

GridView.EmptyDataRowStyle Property

Note: This property is new in the .NET Framework version 2.0.

Gets a reference to the TableItemStyle object that allows you to set the appearance of the empty data row rendered when a GridView control is bound to a data source that does not contain any records.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public TableItemStyle EmptyDataRowStyle { get; }
/** @property */
public TableItemStyle get_EmptyDataRowStyle ()

public function get EmptyDataRowStyle () : TableItemStyle

Property Value

A reference to the TableItemStyle that allows you to set the appearance of the null row.

Use the EmptyDataRowStyle property to control the appearance of the null row in a GridView control. The null row is displayed when the data source that is bound to the control does not contain any records. This property is read-only; however, you can set the properties of the TableItemStyle object it returns. The properties can be set declaratively using one of the following methods:

  • Place an attribute in the opening tag of the GridView control in the form Property-Subproperty, where Subproperty is a property of the TableItemStyle object (for example, EmptyDataRowStyle-ForeColor).

  • Nest an <EmptyDataRowStyle> element between the opening and closing tags of the GridView control.

The properties can also be set programmatically in the form Property.Subproperty (for example, EmptyDataRowStyle.ForeColor). Common settings usually include a custom background color, foreground color, and font properties.

The following code example demonstrates how to set the EmptyDataRowStyle property declaratively to specify a light blue background and a red font for the null row.


<%@ 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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft