DetailsView.Caption DetailsView.Caption DetailsView.Caption DetailsView.Caption Property

Definizione

Ottiene o imposta il testo di cui eseguire il rendering in un elemento didascalia HTML in un controllo DetailsView.Gets or sets the text to render in an HTML caption element in a DetailsView control. Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi che assistono i disabili.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

Valore della proprietà

Una stringa che rappresenta il testo di cui eseguire il rendering in un elemento didascalia HTML in un controllo DetailsView.A string that represents the text to render in an HTML caption element in a DetailsView control. Il valore predefinito è una stringa vuota ("").The default value is an empty string ("").

Esempi

Nell'esempio di codice riportato di seguito viene illustrato Caption come utilizzare la proprietà per specificare il testo per l'elemento didascalia DetailsView HTML sottoposto a rendering in un controllo.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>

Commenti

Utilizzare la Caption proprietà per specificare il testo di cui eseguire il rendering in un elemento didascalia HTML in un DetailsView controllo.Use the Caption property to specify the text to render in an HTML caption element in a DetailsView control. Il testo specificato fornisce ai dispositivi di Assistive Technology una descrizione della tabella che può essere utilizzata per rendere il controllo più accessibile.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.

DetailsView IlCaptionAlign supporto per l'accessibilità aggiuntiva per il controllo viene fornito dalla proprietà.Additional accessibility support for the DetailsView control is provided by the CaptionAlign property. Utilizzare la CaptionAlign proprietà per specificare l'allineamento dell'elemento didascalia HTML in un DetailsView controllo.Use the CaptionAlign property to specify the alignment of the HTML caption element in a DetailsView control.

Il valore di Caption viene archiviato nello stato di visualizzazione.The value of Caption is stored in view state.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse tramite uno strumento di progettazione.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Per ulteriori informazioni, vedere LocalizableAttribute e globalizzazione e localizzazione.For more information, see LocalizableAttribute and Globalization and Localization.

Si applica a

Vedi anche