GridView.HeaderStyle Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der Headerzeile in einem GridView-Steuerelement festlegen können.

public:
 property System::Web::UI::WebControls::TableItemStyle ^ HeaderStyle { System::Web::UI::WebControls::TableItemStyle ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.TableItemStyle HeaderStyle { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.HeaderStyle : System.Web.UI.WebControls.TableItemStyle
Public ReadOnly Property HeaderStyle As TableItemStyle

Eigenschaftswert

TableItemStyle

Ein Verweis auf das TableItemStyle-Objekt, das den Stil der Headerzeile in einem GridView-Steuerelement darstellt.

Attribute
PersistenceModeAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Die HeaderStyle -Eigenschaft verwendet wird, um eine benutzerdefinierte Formatvorlage für die Headerzeile in einem GridView Steuerelement zu definieren.


<%@ 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>GridView ShowHeader and ShowFooter Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView ShowHeader and ShowFooter Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        showheader="true"
        showfooter="true"
        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>


<%@ 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>GridView ShowHeader and ShowFooter Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView ShowHeader and ShowFooter Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        showheader="true"
        showfooter="true"
        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>

Hinweise

Verwenden Sie die HeaderStyle -Eigenschaft, um die Darstellung der Kopfzeile in einem GridView Steuerelement zu steuern. Diese Eigenschaft ist schreibgeschützt. Sie können jedoch die Eigenschaften des zurückgegebenen TableItemStyle Objekts festlegen. Die Eigenschaften können deklarativ mit einer der folgenden Methoden festgelegt werden:

  • Platzieren Sie ein Attribut im öffnenden Tag des GridView Steuerelements im Format Property-Subproperty, wobei Subproperty eine Eigenschaft des TableItemStyle -Objekts ist (z. B HeaderStyle-ForeColor. ).

  • Schachteln Sie ein <HeaderStyle> Element zwischen den öffnenden und schließenden Tags des GridView Steuerelements.

Die Eigenschaften können auch programmgesteuert im Formular Property.Subproperty festgelegt werden (z. B. HeaderStyle.ForeColor). Allgemeine Einstellungen umfassen in der Regel eine benutzerdefinierte Hintergrundfarbe, Vordergrundfarbe und Schriftarteigenschaften.

Gilt für:

Weitere Informationen