Sdílet prostřednictvím

GridView.EmptyDataTemplate Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví uživatelem definovaný obsah pro prázdný řádek dat vykreslený, když GridView je ovládací prvek vázán na zdroj dat, který neobsahuje žádné záznamy.

public:
 virtual property System::Web::UI::ITemplate ^ EmptyDataTemplate { 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.GridViewRow))]
public virtual System.Web.UI.ITemplate EmptyDataTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.GridViewRow))>]
member this.EmptyDataTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property EmptyDataTemplate As ITemplate

Hodnota vlastnosti

ITemplate

A ITemplate , který obsahuje vlastní obsah prázdného datového řádku. Výchozí hodnota je null, což označuje, že tato vlastnost není nastavena.

Atributy
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute

Příklady

Následující příklad ukazuje, jak definovat vlastní šablonu pro prázdný řádek dat zobrazený, když GridView je ovládací prvek vázán na zdroj dat, který neobsahuje žádné záznamy.


<%@ 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 runat="server">
    <title>GridView EmptyDataTemplate Example</title>
</head>
<body>
    <form id="form1" 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"
            alternatetext="No Image" 
            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="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 runat="server">
    <title>GridView EmptyDataTemplate Example</title>
</head>
<body>
    <form id="form1" 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"
            alternatetext="No Image" 
            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>

Poznámky

Prázdný řádek dat se zobrazí v ovládacím GridView prvku, pokud zdroj dat, který je vázán na ovládací prvek neobsahuje žádné záznamy. Pomocí vlastnosti můžete definovat vlastní uživatelské rozhraní (UI) pro prázdný řádek EmptyDataTemplate dat.

Pokud chcete zadat vlastní šablonu pro prázdný řádek dat, nejprve umístěte <EmptyDataTemplate> značky mezi levou a pravou značkou GridView ovládacího prvku. Obsah šablony pak můžete zobrazit mezi levou a pravou <EmptyDataTemplate> značkou. Chcete-li řídit styl prázdného datového řádku, použijte EmptyDataRowStyle vlastnost. Alternativně můžete použít integrované uživatelské rozhraní pro prázdný řádek dat nastavením EmptyDataText vlastnosti místo této vlastnosti.

Informace o tom, jak programově přistupovat k ovládacím prvkům, které deklarujete v prázdné datové šabloně, naleznete v tématu Postupy: Přístup k ovládacím prvkům serveru podle ID.

Poznámka:

Pokud jsou nastaveny EmptyDataText vlastnosti i EmptyDataTemplate vlastnosti, EmptyDataTemplate má tato vlastnost přednost.

Platí pro

Viz také