Questa documentazione è stata archiviata e non viene gestita.

Proprietà DetailsView.EmptyDataTemplate

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

Ottiene o imposta il contenuto definito dall'utente per la riga di dati vuota di cui viene eseguito il rendering quando un controllo DetailsView è associato a un'origine dati che non contiene record.

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

[TemplateContainerAttribute(typeof(DetailsView))] 
public virtual ITemplate EmptyDataTemplate { get; set; }
/** @property */
public ITemplate get_EmptyDataTemplate ()

/** @property */
public void set_EmptyDataTemplate (ITemplate value)

public function get EmptyDataTemplate () : ITemplate

public function set EmptyDataTemplate (value : ITemplate)

Valore proprietà

Oggetto System.Web.UI.ITemplate con il contenuto personalizzato per la riga di dati vuota. Il valore predefinito è riferimento null (Nothing in Visual Basic), a indicare che questa proprietà non è impostata.

La riga di dati vuota viene visualizzata in un controllo DetailsView quando l'origine dati associata al controllo non contiene record. È possibile definire un'interfaccia utente personalizzata per la riga di dati vuota utilizzando la proprietà EmptyDataTemplate. Per specificare un modello personalizzato per la riga null, inserire innanzitutto i tag <EmptyDataTemplate> tra i tag di apertura e chiusura del controllo DetailsView. È quindi possibile elencare il contenuto del modello inserito tra i tag <EmptyDataTemplate> di apertura e di chiusura. Per definire lo stile della riga di dati vuota, utilizzare la proprietà EmptyDataRowStyle. In alternativa, per la riga di dati vuota è possibile utilizzare l'interfaccia utente incorporata impostando la proprietà EmptyDataText anziché questa proprietà.

NotaNota

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

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà EmptyDataTemplate per creare una riga di dati vuota personalizzata.


<%@ Page language="C#" %>

<html>
  <body>
    <form 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"
                    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>


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

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

.NET Framework

Supportato in: 2.0
Mostra: