Esporta (0) Stampa
Espandi tutto
Espandi Riduci a icona

Proprietà GridView.EmptyDataText

Aggiornamento: novembre 2007

Ottiene o imposta il testo da visualizzare nella riga di dati vuota di cui viene eseguito il rendering quando un controllo GridView è associato a un'origine dati che non contiene record.

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public virtual string EmptyDataText { get; set; }
/** @property */
public String get_EmptyDataText()
/** @property */
public  void set_EmptyDataText(String value)

public function get EmptyDataText () : String
public function set EmptyDataText (value : String)
<asp:GridView EmptyDataText="String" />

Valore proprietà

Tipo: System.String

Il testo da visualizzare nella riga di dati vuota. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.

La riga di dati vuota viene visualizzata in un controllo GridView quando l'origine dati associata al controllo non contiene record. Utilizzare la proprietà EmptyDataText per specificare il testo da visualizzare nella riga di dati vuota. Per definire lo stile della riga di dati vuota, utilizzare la proprietà EmptyDataRowStyle. In alternativa, per la riga di dati vuota è possibile definire un'interfaccia utente personalizzata impostando la proprietà EmptyDataTemplate anziché questa proprietà.

Nota:

Se sono impostate le proprietà EmptyDataText e EmptyDataTemplate, la proprietà EmptyDataTemplate ha la precedenza.

Il valore di questa proprietà, se impostata, può essere salvato automaticamente in un file di risorse utilizzando uno strumento di progettazione. Per ulteriori informazioni, vedereLocalizableAttribute e Globalizzazione e localizzazione ASP.NET.

Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà EmptyDataText per specificare il testo da visualizzare nella riga di dati vuota.


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



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft