GridView.CaptionAlign Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit la position horizontale ou verticale de l'élément de légende HTML dans un contrôle GridView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.

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

Valeur de propriété

TableCaptionAlign

Une des valeurs de l'objet TableCaptionAlign. La valeur par défaut est TableCaptionAlign.NotSet, qui utilise le paramètre par défaut du navigateur.

Exceptions

ArgumentOutOfRangeException

La valeur spécifiée n'est pas l'une des valeurs d'énumération TableCaptionAlign.

Exemples

L’exemple suivant montre comment utiliser la CaptionAlign propriété pour spécifier que l’élément de légende d’un GridView contrôle est aligné sur le haut du contrôle.


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

Remarques

Utilisez la CaptionAlign propriété pour spécifier la position horizontale ou verticale de l’élément de légende HTML dans un GridView contrôle. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.

Cette propriété est définie à l’aide de l’une TableCaptionAlign des valeurs d’énumération. Le tableau suivant répertorie les valeurs possibles.

Valeur Description
TableCaptionAlign.Bottom L'élément de légende s'aligne sur le bas du tableau.
TableCaptionAlign.Left L'élément de légende s'aligne sur le côté gauche du tableau.
TableCaptionAlign.NotSet L’alignement de l’élément de légende n’est pas défini.
TableCaptionAlign.Right L'élément de légende s'aligne sur le côté droit du tableau.
TableCaptionAlign.Top L'élément de légende s'aligne sur le haut du tableau.

Notes

Lorsque cette propriété est définie TableCaptionAlign.NotSetsur , la valeur par défaut du navigateur est utilisée.

Pour spécifier le texte de l’élément de légende HTML, utilisez la Caption propriété.

S’applique à

Voir aussi