GridView.RowHeaderColumn Eigenschaft

Definition

Ruft den Namen der Spalte ab, die als Spaltenheader für das GridView-Steuerelement verwendet werden soll, oder legt den Namen fest.Gets or sets the name of the column to use as the column header for the GridView control. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.This property is provided to make the control more accessible to users of assistive technology devices.

public:
 virtual property System::String ^ RowHeaderColumn { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataColumnSelectionConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataColumnSelectionConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string RowHeaderColumn { get; set; }
member this.RowHeaderColumn : string with get, set
Public Overridable Property RowHeaderColumn As String

Eigenschaftswert

Der Name der Spalte, der als Spaltenheader verwendet werden soll.The name of the column to use as the column header. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.The default is an empty string (""), which indicates that this property is not set.

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die RowHeaderColumn -Eigenschaft verwendet wird, um eine Header GridView Spalte in einem-Steuerelement anzuzeigen.The following example demonstrates how to use the RowHeaderColumn property to display a header column 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 RowHeaderColumn Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView RowHeaderColumn Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true"
        rowheadercolumn="CustomerID"  
        runat="server">
      </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 RowHeaderColumn Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView RowHeaderColumn Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true"
        rowheadercolumn="CustomerID"  
        runat="server">
      </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

In HTML kann der Header einer Tabelle entweder einer Zeile oder einer Spalte zugeordnet werden.In HTML, the header of a table can be associated with either a row or a column. Die Richtung wird durch Festlegen des scope -Attributs <th> der-Elemente angegeben.The direction is specified by setting the scope attribute of the <th> elements. Das GridView -Steuerelement verfügt über eine integrierte Kopfzeile, die angezeigt werden kann, ShowHeader indem die true-Eigenschaft auf festgelegt wird.The GridView control has a built-in header row that can be displayed by setting the ShowHeader property to true. Sie können optional auch eine Header Spalte (normalerweise die erste oder letzte Spalte im GridView -Steuerelement) angeben, indem Sie diese Eigenschaft festlegen.You can also optionally specify a header column (usually the first or last column in the GridView control) by setting this property. Wenn diese Eigenschaft festgelegt ist, werden alle Zellen in der Spalte, die dem angegebenen Feldnamen entsprechen, <th scope="row"> als-Elemente gerendert.When this property is set, all cells in the column that corresponds to the specified field name are rendered as <th scope="row"> elements.

Hinweis

Obwohl die angegebene Spalte wie eine Kopfzeile behandelt wird, HeaderStylegelten ShowHeaderdie Eigenschaften UseAccessibleHeader , und nicht für die Header Spalte.Although the specified column is treated like a header, the HeaderStyle, ShowHeader, and UseAccessibleHeader properties do not apply to the header column.

Das Standard Rendering des <th> Elements wird beibehalten, sodass der Text fett formatiert und horizontal zentriert wird.The default rendering of the <th> element is preserved, rendering text as bold and centered horizontally. Entwickler können das Verhalten des <th> -Elements überschreiben, indem Sie ein Cascading Stylesheet verwenden.Developers can override the behavior of the <th> element using a cascading style sheet.

Hinweis

Diese Eigenschaft kann nur mit gebundenen Feldern verwendet werden.This property works only with bound fields. Sie funktioniert nicht mit Vorlagen Feldern.It does not work with template fields.

Gilt für:

Siehe auch