GridView.HeaderStyle Eigenschaft

Definition

Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der Headerzeile in einem GridView-Steuerelement festlegen können.Gets a reference to the TableItemStyle object that enables you to set the appearance of the header row in a GridView control.

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; }
member this.HeaderStyle : System.Web.UI.WebControls.TableItemStyle
Public ReadOnly Property HeaderStyle As TableItemStyle

Eigenschaftswert

Ein Verweis auf das TableItemStyle-Objekt, das den Stil der Headerzeile in einem GridView-Steuerelement darstellt.A reference to the TableItemStyle that represents the style of the header row in a GridView control.

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die HeaderStyle -Eigenschaft verwendet wird, um einen benutzerdefinierten Stil für die GridView Kopfzeile in einem-Steuerelement zu definieren.The following example demonstrates how to use the HeaderStyle property to define a custom style for the header row in a GridView control.


<%@ 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 HeaderStyle die-Eigenschaft, um die Darstellung der Header Zeile in GridView einem-Steuerelement zu steuern.Use the HeaderStyle property to control the appearance of the header row in a GridView control. Diese Eigenschaft ist schreibgeschützt. Sie können jedoch die Eigenschaften des TableItemStyle zurückgegebenen Objekts festlegen.This property is read-only; however, you can set the properties of the TableItemStyle object it returns. Die Eigenschaften können mithilfe einer der folgenden Methoden deklarativ festgelegt werden:The properties can be set declaratively using one of the following methods:

  • Platzieren Sie ein Attribut im öffnenden Tag des GridView -Steuer Elements im Property-SubpropertyFormular, Subproperty wobei eine HeaderStyle-ForeColorEigenschaft des TableItemStyle -Objekts ist (z. b.).Place an attribute in the opening tag of the GridView control in the form Property-Subproperty, where Subproperty is a property of the TableItemStyle object (for example, HeaderStyle-ForeColor).

  • Schachteln Sie <HeaderStyle> ein-Element zwischen dem öffnenden und dem GridView schließenden Tag des-Steuer Elements.Nest a <HeaderStyle> element between the opening and closing tags of the GridView control.

Die Eigenschaften können auch Programm gesteuert im Formular Property.Subproperty ( HeaderStyle.ForeColorz. b.) festgelegt werden.The properties can also be set programmatically in the form Property.Subproperty (for example, HeaderStyle.ForeColor). Allgemeine Einstellungen umfassen in der Regel eine benutzerdefinierte Hintergrundfarbe, Vordergrundfarbe und Schriftart Eigenschaften.Common settings usually include a custom background color, foreground color, and font properties.

Gilt für:

Siehe auch