Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

GridView.HeaderRow propriété

 

Date de publication : novembre 2016

Obtient un GridViewRow objet qui représente la ligne d’en-tête dans un GridView contrôle.

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

[BrowsableAttribute(false)]
public virtual GridViewRow HeaderRow { get; }

Valeur de propriété

Type: System.Web.UI.WebControls.GridViewRow

Un GridViewRow qui représente la ligne d’en-tête dans un GridView contrôle.

Utilisez le HeaderRow propriété pour accéder par programme le GridViewRow objet qui représente la ligne d’en-tête dans un GridView contrôle.

System_CAPS_noteRemarque

Le HeaderRow propriété n’est disponible qu’après la GridView contrôle crée la ligne d’en-tête dans le RowCreated événement.

Cette propriété est couramment utilisée lorsque vous devez manipuler par programme la ligne d’en-tête, par exemple, lors de l’ajout de contenu personnalisé. Toute modification apportée à la HeaderRow propriété doit être effectuée après la GridView contrôle a été rendu ; sinon, le GridView contrôle remplacera les modifications.

L’exemple suivant montre comment utiliser le HeaderRow propriété à modifier par programme la couleur de police de la ligne d’en-tête en fonction du sens de tri.


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_DataBound(Object sender, EventArgs e)
  {

    // Get the header row.
    GridViewRow headerRow = CustomersGridView.HeaderRow;   

    // Get the footer row.
    GridViewRow footerRow = CustomersGridView.FooterRow; 

    // Set the font color of the header and footer rows
    // based on the sort direction. 
    switch (CustomersGridView.SortDirection)
    {
      case SortDirection.Ascending:
        headerRow.ForeColor = System.Drawing.Color.Green;
        footerRow.ForeColor = System.Drawing.Color.Green;
        break;
      case SortDirection.Descending:
        headerRow.ForeColor = System.Drawing.Color.Red;
        footerRow.ForeColor = System.Drawing.Color.Red;
        break;
      default:
        headerRow.ForeColor = System.Drawing.Color.Black;
        footerRow.ForeColor = System.Drawing.Color.Black;
        break;
    }

    // Display the sort order in the footer row.
    footerRow.Cells[0].Text = "Sort Order = " + CustomersGridView.SortDirection.ToString();

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView HeaderRow and FooterRow Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>GridView HeaderRow and FooterRow Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowsorting="true"
        allowpaging="true" 
        showheader="true"
        showfooter="true"
        ondatabound="CustomersGridView_DataBound"    
        runat="server">

        <headerstyle backcolor="LightCyan"
          forecolor="MediumBlue"/>

        <footerstyle backcolor="LightCyan"
          forecolor="MediumBlue"/>

      </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.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>

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

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: