GridView.RowHeaderColumn Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el nombre de la columna que se utilizará como encabezado de columna para el control GridView. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.

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

Valor de propiedad

String

Nombre de la columna que se va a utilizar como encabezado de columna. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido esta propiedad.

Atributos
TypeConverterAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo usar la RowHeaderColumn propiedad para mostrar una columna de encabezado en un 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 a una columna. La dirección se especifica estableciendo el scope atributo de los <th> elementos. El GridView control tiene una fila de encabezado integrada que se puede mostrar estableciendo la ShowHeader propiedad trueen . También puede especificar opcionalmente una columna de encabezado (normalmente la primera o la última columna del GridView control) estableciendo esta propiedad. Cuando se establece esta propiedad, todas las celdas de la columna que corresponden al nombre de campo especificado se representan como <th scope="row"> elementos.

Nota

Aunque la columna especificada se trata como un encabezado, las HeaderStylepropiedades , ShowHeadery UseAccessibleHeader no se aplican a la columna de encabezado.

La representación predeterminada del <th> elemento se conserva, representando texto en negrita y centrado horizontalmente. Los desarrolladores pueden invalidar el comportamiento del <th> elemento mediante una hoja de estilos en cascada.

Nota

Esta propiedad solo funciona con campos enlazados. No funciona con campos de plantilla.

Se aplica a

Consulte también