GridView.Caption Propriedade
Definição
Obtém ou define o texto a ser renderizado em um elemento de legenda HTML em um controle GridView.Gets or sets the text to render in an HTML caption element in a GridView control. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa.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
Valor da propriedade
Uma cadeia de caracteres que representa o texto a ser renderizado em um elemento de legenda HTML em um controle GridView.A string that represents the text to render in an HTML caption element in a GridView control. O valor padrão é uma cadeia de caracteres vazia ("").The default value is an empty string ("").
Exemplos
O exemplo a seguir demonstra como usar a Caption propriedade para especificar a legenda de um GridView controle.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>
Comentários
Use a Caption propriedade para especificar o texto a ser processado em um elemento de legenda HTML em um GridView controle.Use the Caption property to specify the text to render in an HTML caption element in a GridView control. O texto que você especificar fornece aos dispositivos de tecnologia assistencial uma descrição da tabela que pode ser usada para tornar o controle mais acessível.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. Você também pode especificar a posição na qual processar o elemento HTML Caption usando a CaptionAlign propriedade.You can also specify the position at which to render the HTML caption element by using the CaptionAlign property.
O valor dessa propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Para obter mais informações, consulte, LocalizableAttribute globalização e localização.For more information, see LocalizableAttribute and Globalization and Localization.