Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Propriedade GridView.EmptyDataText

 

Obtém ou define o texto a ser exibido na linha de dados vazia renderizada quando um controle GridView é associado a uma fonte de dados que não contém registros.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

public virtual string EmptyDataText { get; set; }

Valor da Propriedade

Type: System.String

O texto a ser exibido na linha de dados vazia. O padrão é uma cadeia de caracteres vazia (""), que indica que essa propriedade não está definida.

The empty data row is displayed in a T:System.Web.UI.WebControls.GridView control when the data source that is bound to the control does not contain any records. Use the P:System.Web.UI.WebControls.GridView.EmptyDataText property to specify the text to display in the empty data row. To control the style of the empty data row, use the P:System.Web.UI.WebControls.GridView.EmptyDataRowStyle property. Alternatively, you can define your own custom user interface (UI) for the empty data row by setting the P:System.Web.UI.WebControls.GridView.EmptyDataTemplate property instead of this property.

System_CAPS_noteObservação

If both the P:System.Web.UI.WebControls.GridView.EmptyDataText and P:System.Web.UI.WebControls.GridView.EmptyDataTemplate properties are set, the P:System.Web.UI.WebControls.GridView.EmptyDataTemplate property takes precedence.

The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see T:System.ComponentModel.LocalizableAttribute and ASP.NET Globalization and Localization.

The following example demonstrates how to use the P:System.Web.UI.WebControls.GridView.EmptyDataText property to specify the text to display in the empty data row.


<%@ 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>

.NET Framework
Disponível desde 2.0
Retornar ao início
Mostrar: