GridView.EmptyDataTemplate GridView.EmptyDataTemplate GridView.EmptyDataTemplate GridView.EmptyDataTemplate Property

Definición

Obtiene o establece el contenido definido por el usuario para la fila de datos vacía que se representa cuando un control GridView se enlaza a un origen de datos que no contiene registros.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; }
member this.EmptyDataTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property EmptyDataTemplate As ITemplate

Valor de propiedad

ITemplate con el contenido personalizado de la fila de datos vacía.A ITemplate that contains the custom content for the empty data row. El valor predeterminado es null, que indica que no se ha establecido esta propiedad.The default value is null, which indicates that this property is not set.

Ejemplos

En el ejemplo siguiente se muestra cómo definir una plantilla personalizada para la fila de datos vacía que GridView se muestra cuando un control se enlaza a un origen de datos que no contiene registros.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>

Comentarios

La fila de datos vacía se muestra en GridView un control cuando el origen de datos enlazado al control no contiene ningún registro.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. Puede definir su propia interfaz de usuario (IU) personalizada para la fila de datos vacía mediante la EmptyDataTemplate propiedad.You can define your own custom user interface (UI) for the empty data row by using the EmptyDataTemplate property.

Para especificar una plantilla personalizada para la fila de datos vacía, coloque <EmptyDataTemplate> primero las etiquetas entre las etiquetas GridView de apertura y cierre del control.To specify a custom template for the empty data row, first place <EmptyDataTemplate> tags between the opening and closing tags of the GridView control. A continuación, puede mostrar el contenido de la plantilla entre las etiquetas de <EmptyDataTemplate> apertura y cierre.You can then list the contents of the template between the opening and closing <EmptyDataTemplate> tags. Para controlar el estilo de la fila de datos vacía, utilice EmptyDataRowStyle la propiedad.To control the style of the empty data row, use the EmptyDataRowStyle property. Como alternativa, puede usar la interfaz de usuario integrada para la fila de datos vacía si establece la EmptyDataText propiedad en lugar de esta propiedad.Alternatively, you can use the built-in UI for the empty data row by setting the EmptyDataText property instead of this property.

Para obtener información sobre cómo tener acceso mediante programación a los controles que se declaran en una plantilla de datos vacía, consulte Cómo: Obtener acceso a los controlesde servidor por identificador.For information about how to programmatically access controls that you declare in an empty data template, see How to: Access Server Controls by ID.

Nota

Si se establecen EmptyDataText las EmptyDataTemplate propiedades y, la EmptyDataTemplate propiedad tiene prioridad.If both the EmptyDataText and EmptyDataTemplate properties are set, the EmptyDataTemplate property takes precedence.

Se aplica a

Consulte también: