Udostępnij za pośrednictwem

GridView.EmptyDataTemplate Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia zawartość zdefiniowaną przez użytkownika dla pustego wiersza danych renderowanego, gdy kontrolka GridView jest powiązana ze źródłem danych, które nie zawiera żadnych rekordów.

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

Wartość właściwości

ITemplate

Element ITemplate zawierający zawartość niestandardową dla pustego wiersza danych. Wartość domyślna to null, która wskazuje, że ta właściwość nie jest ustawiona.

Atrybuty
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute

Przykłady

W poniższym przykładzie pokazano, jak zdefiniować szablon niestandardowy dla pustego wiersza danych wyświetlanego, gdy kontrolka GridView jest powiązana ze źródłem danych, które nie zawiera żadnych rekordów.


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

Uwagi

Pusty wiersz danych jest wyświetlany w kontrolce, gdy źródło danych powiązane z kontrolką GridView nie zawiera żadnych rekordów. Możesz zdefiniować własny niestandardowy interfejs użytkownika dla pustego wiersza danych przy użyciu EmptyDataTemplate właściwości .

Aby określić szablon niestandardowy dla pustego wiersza danych, należy najpierw umieścić <EmptyDataTemplate> tagi między tagami otwierania i zamykania kontrolki GridView . Następnie można wyświetlić listę zawartości szablonu między tagami otwierania i zamykania <EmptyDataTemplate> . Aby kontrolować styl pustego wiersza danych, użyj EmptyDataRowStyle właściwości . Alternatywnie możesz użyć wbudowanego interfejsu użytkownika dla pustego wiersza danych, ustawiając EmptyDataText właściwość zamiast tej właściwości.

Aby uzyskać informacje o programowych kontrolach dostępu zadeklarowanych w pustym szablonie danych, zobacz How to: Access Server Controls by ID (Instrukcje: kontrola serwera dostępu według identyfikatora).

Uwaga

Jeśli właściwości EmptyDataText i EmptyDataTemplate są ustawione, EmptyDataTemplate właściwość ma pierwszeństwo.

Dotyczy

Zobacz też