Sdílet prostřednictvím

GridView.RowHeaderColumn Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví název sloupce, který se má použít jako záhlaví sloupce pro GridView ovládací prvek. Tato vlastnost je poskytována, aby byl ovládací prvek přístupnější uživatelům zařízení technologie usnadnění.

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

Hodnota vlastnosti

String

Název sloupce, který se má použít jako záhlaví sloupce. Výchozí hodnota je prázdný řetězec (""), který označuje, že tato vlastnost není nastavena.

Atributy
TypeConverterAttribute

Příklady

Následující příklad ukazuje použití RowHeaderColumn vlastnosti k zobrazení sloupce záhlaví v ovládacím GridView prvku.


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

Poznámky

V HTML může být záhlaví tabulky přidruženo k řádku nebo sloupci. Směr je určen nastavením scope atributu <th> prvků. Ovládací GridView prvek má předdefinovaný řádek záhlaví, který lze zobrazit nastavením ShowHeader vlastnosti na true. Volitelně můžete také zadat sloupec záhlaví (obvykle první nebo poslední sloupec v ovládacím GridView prvku) nastavením této vlastnosti. Při nastavení této vlastnosti se všechny buňky ve sloupci, které odpovídají zadanému názvu pole, vykreslují jako <th scope="row"> prvky.

Poznámka:

I když se zadaný sloupec považuje za záhlaví, HeaderStyleShowHeadervlastnost a UseAccessibleHeader vlastnosti se nevztahují na sloupec záhlaví.

Výchozí vykreslování elementu <th> se zachová a text se zobrazí jako tučný a vodorovně zarovnaný na střed. Vývojáři můžou přepsat chování elementu <th> pomocí šablony stylů CSS.

Poznámka:

Tato vlastnost funguje pouze s vázanými poli. Nefunguje s poli šablony.

Platí pro

Viz také