DetailsView.CaptionAlign Proprietà

Definizione

Ottiene o imposta la posizione orizzontale o verticale dell'elemento didascalia HTML in un controllo DetailsView.Gets or sets the horizontal or vertical position of the 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::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

Valore della proprietà

Uno dei valori di TableCaptionAlign.One of the TableCaptionAlign values. Il valore predefinito è TableCaptionAlign.NotSet.The default is TableCaptionAlign.NotSet.

Eccezioni

Il valore specificato non corrisponde a uno dei valori dell'enumerazione TableCaptionAlign.The specified value is not one of the TableCaptionAlign enumeration values.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato CaptionAlign come utilizzare la proprietà per specificare che l'elemento didascalia HTML in un DetailsView controllo deve essere sottoposto a rendering sul lato sinistro del controllo.The following code example demonstrates how to use the CaptionAlign property to specify that the HTML caption element in a DetailsView control should be rendered on the left side 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>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 CaptionAlign proprietà per specificare la posizione orizzontale o verticale dell'elemento didascalia HTML in un DetailsView controllo.Use the CaptionAlign property to specify the horizontal or vertical position of the 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.

Questa proprietà viene impostata utilizzando uno dei valori TableCaptionAlign di enumerazione.This property is set using one of the TableCaptionAlign enumeration values. Nella tabella seguente sono elencati i valori possibili.The following table lists the possible values.

ValueValue DescriptionDescription
TableCaptionAlign.Bottom L'elemento didascalia è allineato alla parte inferiore della tabella.The caption element is aligned with the bottom of the table.
TableCaptionAlign.Left L'elemento didascalia è allineato alla parte sinistra della tabella.The caption element is aligned with the left side of the table.
TableCaptionAlign.NotSet L'allineamento dell'elemento didascalia non è impostato.The caption element's alignment is not set.
TableCaptionAlign.Right L'elemento didascalia è allineato alla parte destra della tabella.The caption element is aligned with the right side of the table.
TableCaptionAlign.Top L'elemento didascalia è allineato alla parte superiore della tabella.The caption element is aligned with the top of the table.

DetailsView IlCaption supporto per l'accessibilità aggiuntiva per il controllo viene fornito dalla proprietà.Additional accessibility support for the DetailsView control is provided by the Caption property. 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 valore di CaptionAlign viene archiviato nello stato di visualizzazione.The value of CaptionAlign is stored in view state.

Si applica a

Vedi anche