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

FormView.HeaderText, propriété

Mise à jour : novembre 2007

Obtient ou définit le texte à afficher dans la ligne d'en-tête d'un contrôle FormView.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

public virtual string HeaderText { get; set; }
/** @property */
public String get_HeaderText()
/** @property */
public  void set_HeaderText(String value)

public function get HeaderText () : String
public function set HeaderText (value : String)
<asp:FormView HeaderText="String" />

Valeur de propriété

Type : System.String

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

La ligne d'en-tête s'affiche en haut du contrôle FormView lorsque la propriété HeaderText ou HeaderTemplate est définie. Utilisez la propriété HeaderText pour spécifier le texte à afficher dans la ligne d'en-tête. Pour contrôler le style de la ligne d'en-tête, utilisez la propriété HeaderStyle. Vous pouvez également définir votre propre interface utilisateur personnalisée pour la ligne d'en-tête en définissant la propriété HeaderTemplate à la place de cette propriété.

Remarque :

Si les deux propriétés HeaderText et HeaderTemplate sont définies, la propriété HeaderTemplate 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é HeaderText pour spécifier le texte à afficher dans la ligne d'en-tête.


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

      <h3>FormView HeaderText Example</h3>

      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true" 
        datakeynames="EmployeeID"
        headertext="Employee Name" 
        runat="server">

        <headerstyle horizontalalign="Center"
          forecolor="White"
          backcolor="Blue"/>

        <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.                            -->
      <asp:sqldatasource id="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        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: