FormView.EmptyDataTemplate Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el contenido definido por el usuario para la fila de datos vacía que se representa cuando un control FormView se enlaza a un origen de datos que no contiene registros.
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.FormView))]
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.FormView))>]
member this.EmptyDataTemplate : System.Web.UI.ITemplate with get, setPublic Overridable Property EmptyDataTemplate As ITemplateValor de propiedad
ITemplate con el contenido personalizado de la fila de datos vacía. El valor predeterminado es null, que indica que no se ha establecido esta propiedad.
- Atributos
Ejemplos
En el ejemplo siguiente se muestra cómo definir una plantilla personalizada para la fila de datos vacía que se muestra cuando un FormView control está enlazado a un origen de datos que no contiene ningún registro.
<%@ 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>FormView EmptyDataTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView EmptyDataTemplate Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<EmptyDataRowStyle BackColor="Red"
height="100"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
<emptydatatemplate>
<table>
<tr>
<td>
<asp:image id="NoDataImage"
imageurl="~/Images/NoDataImage.jpg"
alternatetext="No image"
runat="server"/>
</td>
<td>
No records available.
</td>
</tr>
</table>
</emptydatatemplate>
<pagersettings position="Bottom"
mode="NextPrevious"/>
</asp:formview>
<!-- 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 select query for the following SqlDataSource -->
<!-- control is intentionally set to return no results -->
<!-- to demonstrate the empty data row. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees] Where [EmployeeID]=1000"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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>FormView EmptyDataTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView EmptyDataTemplate Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<EmptyDataRowStyle BackColor="Red"
height="100"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
<emptydatatemplate>
<table>
<tr>
<td>
<asp:image id="NoDataImage"
imageurl="~/Images/NoDataImage.jpg"
alternatetext="No image"
runat="server"/>
</td>
<td>
No records available.
</td>
</tr>
</table>
</emptydatatemplate>
<pagersettings position="Bottom"
mode="NextPrevious"/>
</asp:formview>
<!-- 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 select query for the following SqlDataSource -->
<!-- control is intentionally set to return no results -->
<!-- to demonstrate the empty data row. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees] Where [EmployeeID]=1000"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Comentarios
La fila de datos vacía se muestra en un FormView control cuando el origen de datos enlazado al control no contiene ningún registro. Puede definir su propia interfaz de usuario personalizada (UI) para la fila de datos vacía mediante la EmptyDataTemplate propiedad . Para especificar una plantilla personalizada para la fila de datos vacía, coloque primero <EmptyDataTemplate> las etiquetas entre las etiquetas de apertura y cierre del FormView control. A continuación, puede enumerar el contenido de la plantilla entre las etiquetas de apertura y cierre <EmptyDataTemplate> . Para controlar el estilo de la fila de datos vacía, use la EmptyDataRowStyle propiedad . Como alternativa, puede usar la interfaz de usuario integrada para la fila de datos vacía estableciendo la EmptyDataText propiedad en lugar de esta propiedad.
Nota:
Si se establecen las EmptyDataText propiedades y EmptyDataTemplate , la EmptyDataTemplate propiedad tiene prioridad.
