GridView.UseAccessibleHeader Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si un control GridView representa su encabezado en un formato accesible. 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 bool UseAccessibleHeader { bool get(); void set(bool value); };
public virtual bool UseAccessibleHeader { get; set; }
member this.UseAccessibleHeader : bool with get, set
Public Overridable Property UseAccessibleHeader As Boolean
Valor de propiedad
Es true
si el control GridView representa su encabezado en un formato accesible; de lo contrario, es false
. De manera predeterminada, es true
.
Ejemplos
En el ejemplo siguiente se muestra cómo usar la UseAccessibleHeader propiedad para deshabilitar el encabezado accesible.
<%@ 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 UseAccessibleHeader Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView UseAccessibleHeader Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
emptydatatext="No data available."
allowpaging="true"
useaccessibleheader="false"
runat="server">
<headerstyle backcolor="LightSteelBlue"
font-names="Verdana"
font-italic="true"
font-size="12"
forecolor="Blue"/>
</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 UseAccessibleHeader Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView UseAccessibleHeader Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
emptydatatext="No data available."
allowpaging="true"
useaccessibleheader="false"
runat="server">
<headerstyle backcolor="LightSteelBlue"
font-names="Verdana"
font-italic="true"
font-size="12"
forecolor="Blue"/>
</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
Utilice la UseAccessibleHeader propiedad para especificar si el GridView control representa su fila de encabezado en un formato accesible. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda. De forma predeterminada, el valor de esta propiedad es true
y el encabezado del control se representa mediante <th>
etiquetas de celda de encabezado de tabla. Además, se agrega un scope="col"
atributo al encabezado de tabla para especificar que el encabezado se aplica a todas las celdas de la columna. La representación predeterminada del <th>
elemento se conserva, representando el texto en negrita y centrado horizontalmente. Los desarrolladores pueden invalidar el estilo del <th>
elemento mediante una hoja de estilos en cascada.
Si el valor de esta propiedad es false
, el encabezado del control se representa mediante <td>
etiquetas de celda de tabla.