GridView.RowHeaderColumn Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Namen der Spalte ab, die als Spaltenheader für das GridView-Steuerelement verwendet werden soll, oder legt den Namen fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.

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=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string RowHeaderColumn { get; set; }

[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataColumnSelectionConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string RowHeaderColumn { get; set; }

[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataColumnSelectionConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.RowHeaderColumn : string with get, set

[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataColumnSelectionConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.RowHeaderColumn : string with get, set

Public Overridable Property RowHeaderColumn As String

Eigenschaftswert

String

Der Name der Spalte, der als Spaltenheader verwendet werden soll. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Attribute: TypeConverterAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die RowHeaderColumn -Eigenschaft verwenden, um eine Headerspalte in einem GridView Steuerelement anzuzeigen.


<%@ 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. Die Richtung wird durch Festlegen des scope Attributs der <th> Elemente angegeben. Das GridView Steuerelement verfügt über eine integrierte Headerzeile, die durch Festlegen der ShowHeader -Eigenschaft auf trueangezeigt werden kann. Sie können auch optional eine Kopfzeilenspalte (in der Regel die erste oder letzte Spalte im GridView Steuerelement) angeben, indem Sie diese Eigenschaft festlegen. Wenn diese Eigenschaft festgelegt ist, werden alle Zellen in der Spalte, die dem angegebenen Feldnamen entsprechen, als <th scope="row"> Elemente gerendert.

Hinweis

Obwohl die angegebene Spalte wie ein Header behandelt wird, gelten die HeaderStyleEigenschaften , ShowHeaderund UseAccessibleHeader nicht für die Headerspalte.

Das Standardrendering des <th> Elements wird beibehalten, wobei Text fett formatiert und horizontal zentriert wird. Entwickler können das Verhalten des <th> Elements mithilfe eines kaskadierenden Stylesheets außer Kraft setzen.

Hinweis

Diese Eigenschaft funktioniert nur mit gebundenen Feldern. Es funktioniert nicht mit Vorlagenfeldern.

Gilt für:

Freigeben über