Freigeben über

GridView.UseAccessibleHeader Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein GridView Steuerelement seine Kopfzeile in einem barrierefreien Format rendert. Diese Eigenschaft wird bereitgestellt, um die Steuerung für Benutzer von Hilfstechnologiegeräten zugänglicher zu machen.

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

Eigenschaftswert

Boolean

true wenn das GridView Steuerelement seine Kopfzeile in einem barrierefreien Format rendert; andernfalls false. Der Standardwert lautet true.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die UseAccessibleHeader Eigenschaft zum Deaktivieren der barrierefreien Kopfzeile verwendet wird.


<%@ 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>

Hinweise

Verwenden Sie die UseAccessibleHeader Eigenschaft, um anzugeben, ob das GridView Steuerelement seine Kopfzeile in einem barrierefreien Format rendert. Diese Eigenschaft wird bereitgestellt, um die Steuerung für Benutzer von Hilfstechnologiegeräten zugänglicher zu machen. Standardmäßig wird true der Wert dieser Eigenschaft und die Kopfzeile für das Steuerelement mithilfe von <th> Tabellenüberschriftenzellentags gerendert. Darüber hinaus wird der Tabellenüberschrift ein scope="col" Attribut hinzugefügt, um anzugeben, dass die Kopfzeile für alle Zellen in der Spalte gilt. Das Standardrendering des <th> Elements wird beibehalten, wobei Text fett formatiert und horizontal zentriert dargestellt wird. Entwickler können die Formatvorlage des <th> Elements mithilfe eines Cascading Stylesheets überschreiben.

Wenn der Wert dieser Eigenschaft lautet false, wird die Kopfzeile für das Steuerelement mithilfe <td> von Tabellenzellentags gerendert.

Gilt für:

Weitere Informationen