Partager via

DetailsView.CaptionAlign Propriété

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 DetailsView contrôle. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d’appareils technologiques 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 TableCaptionAlign valeurs. La valeur par défaut est TableCaptionAlign.NotSet.

Exceptions

ArgumentOutOfRangeException

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

Exemples

L’exemple de code suivant montre comment utiliser la CaptionAlign propriété pour spécifier que l’élément de légende HTML dans un DetailsView contrôle doit être rendu sur le côté gauche 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>DetailsView Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView Caption and CaptionAlign Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true"
          caption="Customer Details"
          captionalign="Left"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- 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="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </asp:SqlDataSource>
    </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>DetailsView Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView Caption and CaptionAlign Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true"
          caption="Customer Details"
          captionalign="Left"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- 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="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </asp:SqlDataSource>
    </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 DetailsView contrôle. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d’appareils technologiques 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 est aligné sur le bas du tableau.
TableCaptionAlign.Left L’élément de légende est aligné 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 est aligné sur le côté droit de la table.
TableCaptionAlign.Top L’élément de légende est aligné sur le haut du tableau.

Une prise en charge supplémentaire de l’accessibilité pour le DetailsView contrôle est fournie par la Caption propriété. Utilisez la Caption propriété pour spécifier le texte à afficher dans un élément de légende HTML dans un DetailsView contrôle.

La valeur de celle-ci CaptionAlign est stockée dans l’état d’affichage.

S’applique à

Voir aussi