GridView.EmptyDataTemplate Vlastnost

Definice

Získá nebo nastaví uživatelsky definovaný obsah pro prázdný řádek dat vykreslený v případě GridView , že je ovládací prvek svázán se zdrojem dat, který neobsahuje žádné záznamy.Gets or sets the user-defined content for the empty data row rendered when a GridView control is bound to a data source that does not contain any records.

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.A ITemplate that contains the custom content for the empty data row. Výchozí hodnota je null , což znamená, že tato vlastnost není nastavena.The default value is null, which indicates that this property is not set.

Atributy

Příklady

Následující příklad ukazuje, jak definovat vlastní šablonu pro prázdný řádek dat zobrazený v případě GridView , že je ovládací prvek svázán se zdrojem dat, který neobsahuje žádné záznamy.The following example demonstrates how to define a custom template for the empty data row displayed when a GridView control is bound to a data source that does not contain any records.


<%@ 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ý datový řádek se zobrazí v GridView ovládacím prvku, když zdroj dat, který je svázán s ovládacím prvkem, neobsahuje žádné záznamy.The empty data row is displayed in a GridView control when the data source that is bound to the control does not contain any records. Můžete definovat vlastní uživatelské rozhraní (UI) pro prázdný řádek dat pomocí EmptyDataTemplate Vlastnosti.You can define your own custom user interface (UI) for the empty data row by using the EmptyDataTemplate property.

Chcete-li zadat vlastní šablonu pro prázdný řádek dat, umístěte nejprve <EmptyDataTemplate> značky mezi otevírací a uzavírací značku GridView ovládacího prvku.To specify a custom template for the empty data row, first place <EmptyDataTemplate> tags between the opening and closing tags of the GridView control. Pak můžete vypsat obsah šablony mezi otevíracími a ukončovacími <EmptyDataTemplate> značkami.You can then list the contents of the template between the opening and closing <EmptyDataTemplate> tags. Chcete-li řídit styl prázdného řádku dat, použijte EmptyDataRowStyle vlastnost.To control the style of the empty data row, use the EmptyDataRowStyle property. Alternativně můžete použít vestavěné uživatelské rozhraní pro prázdný řádek dat nastavením EmptyDataText vlastnosti namísto této vlastnosti.Alternatively, you can use the built-in UI for the empty data row by setting the EmptyDataText property instead of this property.

Informace o tom, jak programově přistupovat k ovládacím prvkům, které jsou deklarovány v prázdné šabloně dat, naleznete v tématu How to: Access Server Controls by ID.For information about how to programmatically access controls that you declare in an empty data template, see How to: Access Server Controls by ID.

Poznámka

Pokud EmptyDataText EmptyDataTemplate jsou nastaveny vlastnosti a, má EmptyDataTemplate vlastnost přednost.If both the EmptyDataText and EmptyDataTemplate properties are set, the EmptyDataTemplate property takes precedence.

Platí pro

Viz také