DetailsView.EmptyDataTemplate Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o conteúdo definido pelo utilizador para a linha de dados vazia renderizada quando um DetailsView controlo está vinculado a uma fonte de dados que não contém registos.
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.DetailsView))]
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.DetailsView))>]
member this.EmptyDataTemplate : System.Web.UI.ITemplate with get, setPublic Overridable Property EmptyDataTemplate As ITemplateValor de Propriedade
A ITemplate que contém o conteúdo personalizado da linha de dados vazia. O valor padrão é null, o que indica que esta propriedade não está definida.
- Atributos
Exemplos
O exemplo de código seguinte demonstra como usar a EmptyDataTemplate propriedade para criar uma linha de dados vazia personalizada.
<%@ 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>DetailsView EmptyDataTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsView EmptyDataTemplate Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="StoresDetailsSqlDataSource"
autogeneraterows="true"
EmptyDataText="No records."
runat="server">
<emptydatarowstyle backcolor="Navy"
forecolor="Red"/>
<emptydatatemplate>
<table width="100%">
<tr>
<td>
<asp:Image id="NoRecordsImage"
AlternateText='No records'
imageurl="~\images\NoRecords.jpg"
runat="server"/>
</td>
<td>
<asp:Label id="NoRecordsMessageLabel"
forecolor="Red"
text="No Records."
runat="server"/>
</td>
</tr>
</table>
</emptydatatemplate>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<!-- The select query of the following SqlDataSource -->
<!-- control has been intentionally set to return no -->
<!-- results to demonstrate the empty data row. -->
<asp:sqldatasource id="StoresDetailsSqlDataSource"
selectcommand="SELECT [stor_id], [stor_name], [stor_address], [city], [state], [zip] FROM [stores] WHERE [state]='FL'"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
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>DetailsView EmptyDataTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsView EmptyDataTemplate Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="StoresDetailsSqlDataSource"
autogeneraterows="true"
EmptyDataText="No records."
runat="server">
<emptydatarowstyle backcolor="Navy"
forecolor="Red"/>
<emptydatatemplate>
<table width="100%">
<tr>
<td>
<asp:Image id="NoRecordsImage"
AlternateText='No Records'
imageurl="~\images\NoRecords.jpg"
runat="server"/>
</td>
<td>
<asp:Label id="NoRecordsMessageLabel"
forecolor="Red"
text="No records."
runat="server"/>
</td>
</tr>
</table>
</emptydatatemplate>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<!-- The select query of the following SqlDataSource -->
<!-- control has been intentionally set to return no -->
<!-- results to demonstrate the empty data row. -->
<asp:sqldatasource id="StoresDetailsSqlDataSource"
selectcommand="SELECT [stor_id], [stor_name], [stor_address], [city], [state], [zip] FROM [stores] WHERE [state]='FL'"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Observações
A linha de dados vazia é exibida num DetailsView controlo quando a fonte de dados vinculada ao controlo não contém registos. Pode definir a sua própria interface de utilizador personalizada (UI) para a linha de dados vazia usando a EmptyDataTemplate propriedade. Para especificar um modelo personalizado para a linha nula, primeiro coloque <EmptyDataTemplate> etiquetas entre as etiquetas de abertura e fecho do DetailsView controlo. Pode então listar o conteúdo do modelo entre as etiquetas de abertura e fecho <EmptyDataTemplate> . Para controlar o estilo da linha de dados vazia, use a EmptyDataRowStyle propriedade . Alternativamente, pode usar a interface integrada para a linha de dados vazia, definindo a EmptyDataText propriedade em vez desta propriedade.
Note
Se ambas as EmptyDataText propriedades e EmptyDataTemplate forem definidas, a EmptyDataTemplate propriedade tem precedência.
