GridView.Caption Eigenschaft

Definition

Ruft den Text ab, der in einem HTML-Beschriftungselement eines GridView-Steuerelements gerendert werden soll, oder legt diesen Text fest.Gets or sets the text to render in an HTML caption element in a GridView control. 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 System::String ^ Caption { System::String ^ get(); void set(System::String ^ value); };
public virtual string Caption { get; set; }
member this.Caption : string with get, set
Public Overridable Property Caption As String

Eigenschaftswert

Eine Zeichenfolge, die den Text darstellt, der in einem HTML-Beschriftungselement eines GridView-Steuerelements gerendert werden soll.A string that represents the text to render in an HTML caption element in a GridView control. Der Standardwert ist eine leere Zeichenfolge („“).The default value is an empty string ("").

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Caption -Eigenschaft verwendet wird, um die GridView Beschriftung für ein Steuerelement anzugeben.The following example demonstrates how to use the Caption property to specify the caption for 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 Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Caption and CaptionAlign Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true"
        caption="Customer Information Table"
        captionalign="Top"   
        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 Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Caption and CaptionAlign Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true"
        caption="Customer Information Table"
        captionalign="Top"   
        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>

Hinweise

Verwenden Sie Caption die-Eigenschaft, um den Text anzugeben, der in einem HTML- GridView Beschriftungs Element in einem-Steuerelement zuUse the Caption property to specify the text to render in an HTML caption element in a GridView control. Der von Ihnen angegebene Text bietet Hilfstechnologiegeräte mit einer Beschreibung der Tabelle, die verwendet werden kann, um das Steuerelement leichter zugänglich zu machen.The text that you specify provides assistive technology devices with a description of the table that can be used to make the control more accessible. Mithilfe der CaptionAlign -Eigenschaft können Sie auch die Position angeben, an der das HTML-Beschriftungs Element dargestellt werden soll.You can also specify the position at which to render the HTML caption element by using the CaptionAlign property.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.For more information, see LocalizableAttribute and Globalization and Localization.

Gilt für:

Siehe auch