GridView.CaptionAlign GridView.CaptionAlign GridView.CaptionAlign GridView.CaptionAlign Property

Definición

Obtiene o establece la posición horizontal o vertical del elemento de título HTML de un control GridView.Gets or sets the horizontal or vertical position of the HTML caption element in a GridView control. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.This property is provided to make the control more accessible to users of assistive technology devices.

public:
 virtual property System::Web::UI::WebControls::TableCaptionAlign CaptionAlign { System::Web::UI::WebControls::TableCaptionAlign get(); void set(System::Web::UI::WebControls::TableCaptionAlign value); };
public virtual System.Web.UI.WebControls.TableCaptionAlign CaptionAlign { get; set; }
member this.CaptionAlign : System.Web.UI.WebControls.TableCaptionAlign with get, set
Public Overridable Property CaptionAlign As TableCaptionAlign

Valor de propiedad

Uno de los valores de TableCaptionAlign.One of the TableCaptionAlign values. El valor predeterminado es TableCaptionAlign.NotSet, que utiliza la configuración predeterminada del explorador.The default is TableCaptionAlign.NotSet, which uses the browser's default setting.

Excepciones

El valor especificado no es ninguno de los valores de la enumeración TableCaptionAlign.The specified value is not one of the TableCaptionAlign enumeration values.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar CaptionAlign la propiedad para especificar que el elemento de título GridView de un control está alineado con la parte superior del control.The following example demonstrates how to use the CaptionAlign property to specify that the caption element for a GridView control is aligned with the top of the 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>

Comentarios

Utilice la CaptionAlign propiedad para especificar la posición horizontal o vertical del elemento de título HTML en un GridView control.Use the CaptionAlign property to specify the horizontal or vertical position of the HTML caption element in a GridView control. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.This property is provided to make the control more accessible to users of assistive technology devices.

Esta propiedad se establece con uno de los TableCaptionAlign valores de enumeración.This property is set using one of the TableCaptionAlign enumeration values. En la tabla siguiente se enumeran los valores posibles.The following table lists the possible values.

ValorValue DescripciónDescription
TableCaptionAlign.Bottom El elemento de título está alineado con la parte inferior de la tabla.The caption element is aligned with the bottom of the table.
TableCaptionAlign.Left El elemento de título está alineado con la parte izquierda de la tabla.The caption element is aligned with the left side of the table.
TableCaptionAlign.NotSet No se ha establecido la alineación del elemento de título.The caption element's alignment is not set.
TableCaptionAlign.Right El elemento de título está alineado con la parte derecha de la tabla.The caption element is aligned with the right side of the table.
TableCaptionAlign.Top El elemento de título está alineado con la parte superior de la tabla.The caption element is aligned with the top of the table.

Nota

Cuando esta propiedad se establece en TableCaptionAlign.NotSet, se usa el valor predeterminado del explorador.When this property is set to TableCaptionAlign.NotSet, the default value of the browser is used.

Para especificar el texto del elemento de título HTML, utilice la Caption propiedad.To specify the text for the HTML caption element, use the Caption property.

Se aplica a

Consulte también: