GridView.RowHeaderColumn Eigenschap

Definitie

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

Hiermee haalt u de naam van de kolom op die moet worden gebruikt als de kolomkop voor het GridView besturingselement. Deze eigenschap wordt verstrekt om het beheer toegankelijker te maken voor gebruikers van ondersteunende technologieapparaten.

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

Waarde van eigenschap

String

De naam van de kolom die moet worden gebruikt als kolomkop. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat deze eigenschap niet is ingesteld.

Kenmerken
TypeConverterAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u de RowHeaderColumn eigenschap gebruikt om een koptekstkolom in een GridView besturingselement weer te geven.


<%@ 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>

Opmerkingen

In HTML kan de koptekst van een tabel worden gekoppeld aan een rij of kolom. De richting wordt opgegeven door het scope kenmerk van de <th> elementen in te stellen. Het GridView besturingselement heeft een ingebouwde veldnamenrij die kan worden weergegeven door de ShowHeader eigenschap in te stellen op true. U kunt desgewenst ook een kopkolom (meestal de eerste of laatste kolom in het GridView besturingselement) opgeven door deze eigenschap in te stellen. Wanneer deze eigenschap is ingesteld, worden alle cellen in de kolom die overeenkomt met de opgegeven veldnaam weergegeven als <th scope="row"> elementen.

Note

Hoewel de opgegeven kolom wordt behandeld als een koptekst, zijn de HeaderStyleen ShowHeaderUseAccessibleHeadereigenschappen niet van toepassing op de kopkolom.

De standaardweergave van het <th> element blijft behouden, waardoor tekst vet en gecentreerd horizontaal wordt weergegeven. Ontwikkelaars kunnen het gedrag van het <th> element overschrijven met behulp van een trapsgewijs opmaakmodel.

Note

Deze eigenschap werkt alleen met afhankelijke velden. Het werkt niet met sjabloonvelden.

Van toepassing op

Zie ook