Cette documentation est archivée et n’est pas conservée.

FormView.EmptyDataText, propriété

Mise à jour : novembre 2007

Obtient ou définit le texte à afficher dans la ligne de données vide rendue lorsqu'un contrôle FormView est lié à une source de données qui ne contient pas d'enregistrements.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans 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:FormView EmptyDataText="String" />

Valeur de propriété

Type : System.String

Texte à afficher dans la ligne de données vide. La valeur par défaut est une chaîne vide (""), ce qui signifie que cette propriété n'est pas définie.

La ligne de données vide est affichée dans un contrôle FormView quand la source de données liée au contrôle ne contient pas d'enregistrement. Utilisez la propriété EmptyDataText pour spécifier le texte à afficher dans la ligne de données vide. Pour contrôler le style de la ligne de données vide, utilisez la propriété EmptyDataRowStyle. Vous pouvez également définir votre propre interface utilisateur personnalisée pour la ligne de données vide en définissant la propriété EmptyDataTemplate à la place de cette propriété.

Remarque :

Si les deux propriétés EmptyDataText et EmptyDataTemplate sont définies, la propriété EmptyDataTemplate est prioritaire.

La valeur de cette propriété, lorsqu'elle est définie, peut être enregistrée automatiquement dans un fichier de ressources en utilisant un outil de conception. Pour plus d'informations, consultez LocalizableAttribute et Globalisation et localisation ASP.NET.

L'exemple suivant montre comment utiliser la propriété EmptyDataText pour spécifier le texte à afficher dans la ligne de données vide.


<%@ 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>FormView EmptyDataText Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>FormView EmptyDataText Example</h3>

      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        emptydatatext="No records available." 
        runat="server">

        <EmptyDataRowStyle BackColor="Red"
          forecolor="White"
          font-size="14"
          font-italic="true" 
          height="100"/> 

        <itemtemplate>

          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %>&nbsp;<%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>

        </itemtemplate>

        <pagersettings position="Bottom"
          mode="NextPrevious"/> 

      </asp:formview>

      <!-- 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 select query for the following SqlDataSource     -->
      <!-- control is intentionally set to return no results    -->
      <!-- to demonstrate the empty data row.                   -->  
      <asp:sqldatasource id="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees] Where [EmployeeID]=1000"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>

    </form>
  </body>
</html>



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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: