GridView.RowHeaderColumn GridView.RowHeaderColumn GridView.RowHeaderColumn GridView.RowHeaderColumn Property

Definizione

Ottiene o imposta il nome della colonna da utilizzare come intestazione di colonna per il controllo GridView.Gets or sets the name of the column to use as the column header for the GridView control. Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi che assistono i disabili.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

Valore della proprietà

Il nome della colonna da utilizzare come intestazione di colonna.The name of the column to use as the column header. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.The default is an empty string (""), which indicates that this property is not set.

Esempi

Nell'esempio seguente viene illustrato come utilizzare la RowHeaderColumn proprietà per visualizzare una colonna di intestazione in GridView un controllo.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>

Commenti

In HTML l'intestazione di una tabella può essere associata a una riga o a una colonna.In HTML, the header of a table can be associated with either a row or a column. La direzione viene specificata impostando l' scope attributo <th> degli elementi.The direction is specified by setting the scope attribute of the <th> elements. Il GridView controllo ha una riga di intestazione incorporata che può essere visualizzata impostando la ShowHeader proprietà su true.The GridView control has a built-in header row that can be displayed by setting the ShowHeader property to true. È anche possibile specificare facoltativamente una colonna di intestazione, in GridView genere la prima o l'ultima colonna del controllo, impostando questa proprietà.You can also optionally specify a header column (usually the first or last column in the GridView control) by setting this property. Quando questa proprietà è impostata, viene eseguito il rendering di tutte le celle nella colonna che corrisponde al nome del <th scope="row"> campo specificato come elementi.When this property is set, all cells in the column that corresponds to the specified field name are rendered as <th scope="row"> elements.

Nota

Sebbene la colonna specificata venga considerata come un'intestazione, le HeaderStyleproprietà ShowHeader, e UseAccessibleHeader non si applicano alla colonna di intestazione.Although the specified column is treated like a header, the HeaderStyle, ShowHeader, and UseAccessibleHeader properties do not apply to the header column.

Il rendering predefinito dell' <th> elemento viene mantenuto, rendendo il testo in grassetto e centrato orizzontalmente.The default rendering of the <th> element is preserved, rendering text as bold and centered horizontally. Gli sviluppatori possono eseguire l'override del <th> comportamento dell'elemento utilizzando un foglio di stile CSS.Developers can override the behavior of the <th> element using a cascading style sheet.

Nota

Questa proprietà funziona solo con i campi associati.This property works only with bound fields. Non funziona con i campi modello.It does not work with template fields.

Si applica a

Vedi anche