DetailsView.EmptyDataText Propriété

Définition

Obtient ou définit le texte à afficher dans la ligne de données vide rendue lorsqu'un contrôle DetailsView est lié à une source de données qui ne contient pas d'enregistrements.Gets or sets the text to display in the empty data row rendered when a DetailsView control is bound to a data source that does not contain any records.

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, set
Public Overridable Property EmptyDataText As String

Valeur de propriété

String

Texte à afficher dans la ligne de données vide.The text to display in the empty data row. La valeur par défaut est une chaîne vide (""), ce qui signifie que cette propriété n'est pas définie.The default is an empty string (""), which indicates that this property is not set.

Exemples

L’exemple de code suivant montre comment utiliser la EmptyDataText propriété pour spécifier le texte à afficher dans la ligne de données vide.The following code example demonstrates how to use the 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>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>

Remarques

La ligne de données vide s’affiche dans un DetailsView contrôle lorsque la source de données liée au contrôle ne contient pas d’enregistrements.The empty data row is displayed in a DetailsView control when the data source that is bound to the control does not contain any records. Utilisez la EmptyDataText propriété pour spécifier le texte à afficher dans la ligne de données vide.Use the EmptyDataText property to specify the text to display in the empty data row. Pour contrôler le style de la ligne de données vide, utilisez la EmptyDataRowStyle propriété.To control the style of the empty data row, use the EmptyDataRowStyle property. Vous pouvez également définir votre propre interface utilisateur personnalisée pour la ligne de données vide en définissant la propriété à la EmptyDataTemplate place de cette propriété.Alternatively, you can define your own custom user interface (UI) for the empty data row by setting the EmptyDataTemplate property instead of this property.

Notes

Si les EmptyDataText Propriétés et sont toutes les deux EmptyDataTemplate définies, la EmptyDataTemplate propriété est prioritaire.If both the EmptyDataText and EmptyDataTemplate properties are set, the EmptyDataTemplate property takes precedence.

La valeur de EmptyDataText est stockée dans l’état d’affichage.The value of EmptyDataText is stored in view state.

La valeur de cette propriété, lorsqu’elle est définie, peut être enregistrée automatiquement dans un fichier de ressources à l’aide d’un outil de conception.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Pour plus d’informations, consultez LocalizableAttribute et globalisation et localisation.For more information, see LocalizableAttribute and Globalization and Localization.

S’applique à

Voir aussi