GridView.UseAccessibleHeader Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob das GridView-Steuerelement den zugehörigen Header in einem barrierefreien Format rendert, oder legt diesen Wert fest.Gets or sets a value indicating whether a GridView control renders its header in an accessible format. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.This property is provided to make the control more accessible to users of assistive technology devices.

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

true, wenn das GridView-Steuerelement den zugehörigen Header in einem barrierefreien Format rendert, andernfalls false.true if the GridView control renders its header in an accessible format; otherwise, false. Die Standardeinstellung ist true.The default is true.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die UseAccessibleHeader -Eigenschaft verwendet wird, um den zugänglichen Header zu deaktivieren.The following example demonstrates how to use the UseAccessibleHeader property to disable the accessible header.


<%@ 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 UseAccessibleHeader die-Eigenschaft, um GridView anzugeben, ob das-Steuerelement seine Kopfzeile in einem barrierefreien Format rendert.Use the UseAccessibleHeader property to specify whether the GridView control renders its header row in an accessible format. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.This property is provided to make the control more accessible to users of assistive technology devices. Standardmäßig ist true der Wert dieser Eigenschaft, und der-Header für das-Steuerelement wird <th> mithilfe von Tabellenheader-zelltags gerendert.By default, the value of this property is true and the header for the control is rendered using <th> table header cell tags. Außerdem wird dem Tabellen scope="col" Header ein-Attribut hinzugefügt, um anzugeben, dass der-Header auf alle Zellen in der Spalte angewendet wird.In addition, a scope="col" attribute is added to the table header to specify that the header applies to all the cells in the column. Das Standard Rendering des <th> Elements wird beibehalten, sodass der Text fett formatiert und horizontal zentriert wird.The default rendering of the <th> element is preserved, rendering text as bold and centered horizontally. Entwickler können den Stil des <th> Elements überschreiben, indem Sie ein Cascading Stylesheet verwenden.Developers can override the style of the <th> element using a cascading style sheet.

Wenn der Wert dieser Eigenschaft ist false, wird der-Header für das-Steuerelement mithilfe <td> von Tabellenzellen Tags gerendert.If the value of this property is false, the header for the control is rendered using <td> table cell tags.

Gilt für:

Siehe auch