GridView.EmptyDataTemplate Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den benutzerdefinierten Inhalt für die leere Datenzeile ab, die gerendert wird, wenn ein GridView-Steuerelement an eine Datenquelle ohne Datensätze gebunden ist, oder legt diesen Inhalt fest.

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

Eigenschaftswert

ITemplate

Eine ITemplate, die den benutzerdefinierten Inhalt für die leere Datenzeile enthält. Der Standardwert ist null und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Attribute: BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine benutzerdefinierte Vorlage für die leere Datenzeile definiert wird, die angezeigt wird, wenn ein GridView Steuerelement an eine Datenquelle gebunden ist, die keine Datensätze enthält.


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

Hinweise

Die leere Datenzeile wird in einem GridView Steuerelement angezeigt, wenn die Datenquelle, die an das Steuerelement gebunden ist, keine Datensätze enthält. Sie können ihre eigene benutzerdefinierte Benutzeroberfläche (UI) für die leere Datenzeile definieren, indem Sie die EmptyDataTemplate -Eigenschaft verwenden.

Um eine benutzerdefinierte Vorlage für die leere Datenzeile anzugeben, platzieren Sie <EmptyDataTemplate> Tags zuerst zwischen den öffnenden und schließenden Tags des GridView Steuerelements. Anschließend können Sie den Inhalt der Vorlage zwischen dem öffnenden und dem schließenden <EmptyDataTemplate> Tag auflisten. Verwenden Sie die -Eigenschaft, um den EmptyDataRowStyle Stil der leeren Datenzeile zu steuern. Alternativ können Sie die integrierte Benutzeroberfläche für die leere Datenzeile verwenden, indem Sie anstelle dieser Eigenschaft die EmptyDataText -Eigenschaft festlegen.

Informationen zum programmgesteuerten Zugriff auf Steuerelemente, die Sie in einer leeren Datenvorlage deklarieren, finden Sie unter Vorgehensweise: Zugreifen auf Serversteuerelemente nach ID.

Hinweis

Wenn sowohl die EmptyDataText -Eigenschaft als EmptyDataTemplate auch die -Eigenschaft festgelegt sind, hat die EmptyDataTemplate -Eigenschaft Vorrang.

Gilt für:

Freigeben über