GridView.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 GridView 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 seguinte demonstra como usar a EmptyDataText propriedade para especificar o texto a mostrar 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>GridView EmptyDataText Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView EmptyDataText Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true"
emptydatatext="No data in the data source."
runat="server">
<emptydatarowstyle backcolor="LightBlue"
forecolor="Red"/>
</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 EmptyDataText Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView EmptyDataText Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true"
emptydatatext="No data in the data source."
runat="server">
<emptydatarowstyle backcolor="LightBlue"
forecolor="Red"/>
</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>
Observações
A linha de dados vazia é exibida num GridView 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 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.
