DetailsView.EmptyDataText 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 texto para ser exibido na linha de dados vazia renderizada quando um DetailsView controlo está associado a uma fonte de dados que não contém registos.
public:
virtual property System::String ^ EmptyDataText { System::String ^ get(); void set(System::String ^ value); };public virtual string EmptyDataText { get; set; }member this.EmptyDataText : string with get, setPublic Overridable Property EmptyDataText As StringValor de Propriedade
O texto a mostrar na linha de dados vazia. O padrão é uma cadeia vazia (""), o que indica que esta propriedade não está definida.
Exemplos
O exemplo de código seguinte demonstra como usar a EmptyDataText propriedade para especificar o texto a ser exibido na linha de dados vazia.
<%@ 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 EmptyDataText Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsView EmptyDataText Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="StoresDetailsSqlDataSource"
autogeneraterows="true"
EmptyDataText="No records."
runat="server">
<emptydatarowstyle backcolor="Navy"
forecolor="Red"/>
</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="<%$ 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>DetailsView EmptyDataText Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsView EmptyDataText Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="StoresDetailsSqlDataSource"
autogeneraterows="true"
EmptyDataText="No records."
runat="server">
<emptydatarowstyle backcolor="Navy"
forecolor="Red"/>
</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="<%$ ConnectionStrings:NorthWindConnectionString%>"
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. Use a EmptyDataText propriedade para especificar o texto a mostrar na linha de dados vazia. Para controlar o estilo da linha de dados vazia, use a EmptyDataRowStyle propriedade . Em alternativa, pode definir a sua própria interface de utilizador personalizada (UI) para a linha de dados vazia, definindo a EmptyDataTemplate propriedade em vez desta propriedade.
Note
Se ambas as EmptyDataText propriedades e EmptyDataTemplate forem definidas, a EmptyDataTemplate propriedade tem precedência.
O valor de EmptyDataText é armazenado no estado de visualização.
O valor desta propriedade, quando definido, pode ser guardado automaticamente num ficheiro de recurso usando uma ferramenta de design. Para mais informações, veja LocalizableAttributeGlobalização e Localização.
