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

Definición

Obtiene o establece el nombre de la columna que se utilizará como encabezado de columna para el control GridView.Gets or sets the name of the column to use as the column header for the GridView control. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.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

Valor de propiedad

Nombre de la columna que se va a utilizar como encabezado de columna.The name of the column to use as the column header. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido esta propiedad.The default is an empty string (""), which indicates that this property is not set.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar RowHeaderColumn la propiedad para mostrar una columna de encabezado GridView en un control.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>

Comentarios

En HTML, el encabezado de una tabla se puede asociar a una fila o una columna.In HTML, the header of a table can be associated with either a row or a column. La dirección se especifica estableciendo el scope atributo de los <th> elementos.The direction is specified by setting the scope attribute of the <th> elements. El GridView control tiene una fila de encabezado integrada que se puede mostrar estableciendo la ShowHeader propiedad en true.The GridView control has a built-in header row that can be displayed by setting the ShowHeader property to true. Opcionalmente, también puede especificar una columna de GridView encabezado (normalmente la primera o la última columna del control) si establece esta propiedad.You can also optionally specify a header column (usually the first or last column in the GridView control) by setting this property. Cuando se establece esta propiedad, todas las celdas de la columna que se corresponden con el nombre de campo especificado se <th scope="row"> representan como elementos.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

Aunque la columna especificada se trata como un encabezado, las HeaderStylepropiedades ShowHeader, y UseAccessibleHeader no se aplican a la columna de encabezado.Although the specified column is treated like a header, the HeaderStyle, ShowHeader, and UseAccessibleHeader properties do not apply to the header column.

Se conserva la representación predeterminada del <th> elemento, lo que representa el texto en negrita y centrado horizontalmente.The default rendering of the <th> element is preserved, rendering text as bold and centered horizontally. Los desarrolladores pueden invalidar el comportamiento <th> del elemento mediante una hoja de estilos en cascada.Developers can override the behavior of the <th> element using a cascading style sheet.

Nota

Esta propiedad solo funciona con campos enlazados.This property works only with bound fields. No funciona con los campos de plantilla.It does not work with template fields.

Se aplica a

Consulte también: