GridView.RowHeaderColumn Vlastnost

  • Reference

Definice

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

Získá nebo nastaví název sloupce, který se použije jako záhlaví GridView sloupce ovládacího prvku. 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, jak použít RowHeaderColumn vlastnost 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

Ve formátu HTML je možné záhlaví tabulky přidružit 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 GridView ovládacího 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

Zadaný sloupec se sice považuje za záhlaví, HeaderStyleShowHeaderale vlastnosti a UseAccessibleHeader vlastnosti se nevztahují na sloupec záhlaví.

Výchozí vykreslování elementu <th> je zachováno, vykreslování textu jako tučného písma a vodorovně na střed. Vývojáři můžou přepsat chování <th> elementu pomocí šablony stylů css.

Poznámka

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

Platí pro

Viz také