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.
Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)
Sintaxis
Visual Basic (Declaración)
<TemplateContainerAttribute(GetType(GridViewRow))> _
Public Overridable Property EmptyDataTemplate As ITemplate
Dim instance As GridView
Dim value As ITemplate
value = instance.EmptyDataTemplate
instance.EmptyDataTemplate = value
[TemplateContainerAttribute(typeof(GridViewRow))]
public virtual ITemplate EmptyDataTemplate { get; set; }
[TemplateContainerAttribute(typeof(GridViewRow))]
public:
virtual property ITemplate^ EmptyDataTemplate {
ITemplate^ get ();
void set (ITemplate^ value);
}
/** @property */
public ITemplate get_EmptyDataTemplate ()
/** @property */
public void set_EmptyDataTemplate (ITemplate value)
public function get EmptyDataTemplate () : ITemplate
public function set EmptyDataTemplate (value : ITemplate)
Valor de propiedad
System.Web.UI.ITemplate con el contenido personalizado de la fila de datos vacía. El valor predeterminado es referencia null (
Nothing en Visual Basic), que indica que no se ha establecido esta propiedad.
Comentarios
La fila de datos vacía se muestra en un control GridView cuando el origen de datos enlazado al control no contiene registros. Puede definir su propia interfaz de usuario (UI) personalizada para la fila de datos vacía por medio de la propiedad EmptyDataTemplate. Si desea especificar una plantilla personalizada para la fila de datos vacía, primero coloque las etiquetas <EmptyDataTemplate> entre las etiquetas de apertura y cierre del control GridView. A continuación, incluya el contenido de la plantilla entre las etiquetas <EmptyDataTemplate> de apertura y cierre. Para controlar el estilo de la fila de datos vacía, utilice la propiedad EmptyDataRowStyle. Alternativamente, puede utilizar la interfaz de usuario integrada para la fila de datos vacía estableciendo la propiedad EmptyDataText en lugar de esta propiedad.
.gif) Nota: |
|---|
| Si se establecen las propiedades EmptyDataText y EmptyDataTemplate, la propiedad EmptyDataTemplate tendrá prioridad. |
Ejemplo
En el ejemplo de código siguiente se muestra cómo definir una plantilla personalizada para la fila de datos vacía que se muestra cuando un control GridView se enlaza a un origen de datos que no contiene registros.
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<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="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<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>
Plataformas
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.
Información de versión
.NET Framework
Compatible con: 3.0, 2.0
Vea también