DetailsView.Caption Propriété

Définition

Obtient ou définit le texte à afficher dans un élément de légende HTML d'un contrôle DetailsView.Gets or sets the text to render in an HTML caption element in a DetailsView control. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.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

Valeur de propriété

String

Chaîne qui représente le texte à afficher dans un élément de légende HTML d'un contrôle DetailsView.A string that represents the text to render in an HTML caption element in a DetailsView control. La valeur par défaut est une chaîne vide ("").The default value is an empty string ("").

Exemples

L’exemple de code suivant montre comment utiliser la Caption propriété pour spécifier le texte de l’élément de légende HTML restitué dans un DetailsView contrôle.The following code example demonstrates how to use the Caption property to specify the text for the HTML caption element rendered in a DetailsView 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>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 Caption propriété pour spécifier le texte à afficher dans un élément de légende HTML dans un DetailsView contrôle.Use the Caption property to specify the text to render in an HTML caption element in a DetailsView control. Le texte que vous spécifiez fournit aux appareils de technologie d’assistance une description de la table qui peut être utilisée pour rendre le contrôle plus accessible.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.

La prise en charge de l’accessibilité supplémentaire pour le DetailsView contrôle est fournie par la CaptionAlign propriété.Additional accessibility support for the DetailsView control is provided by the CaptionAlign property. Utilisez la CaptionAlign propriété pour spécifier l’alignement de l’élément de légende HTML dans un DetailsView contrôle.Use the CaptionAlign property to specify the alignment of the HTML caption element in a DetailsView control.

La valeur de Caption est stockée dans l’état d’affichage.The value of Caption is stored in view state.

La valeur de cette propriété, lorsqu’elle est définie, peut être enregistrée automatiquement dans un fichier de ressources à l’aide d’un outil de conception.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Pour plus d’informations, consultez LocalizableAttribute et globalisation et localisation.For more information, see LocalizableAttribute and Globalization and Localization.

S’applique à

Voir aussi