Sdílet prostřednictvím

GridView.EmptyDataTemplate Vlastnost

  • Reference

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 pro prázdný řádek dat. Výchozí hodnota je null, což znamená, že tato vlastnost není nastavená.

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.

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

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

Poznámka

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

Platí pro

Viz také