DetailsView.CaptionAlign Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la posizione orizzontale o verticale dell'elemento didascalia HTML in un controllo DetailsView. Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi che assistono i disabili.

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à

TableCaptionAlign

Uno dei valori di TableCaptionAlign. Il valore predefinito è TableCaptionAlign.NotSet.

Eccezioni

ArgumentOutOfRangeException

Il valore specificato non corrisponde a uno dei valori dell'enumerazione TableCaptionAlign.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la CaptionAlign proprietà per specificare che il rendering dell'elemento didascalia HTML in un DetailsView controllo deve essere eseguito sul lato sinistro del controllo.


<%@ 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 . Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi che assistono i disabili.

Questa proprietà viene impostata utilizzando uno dei valori di TableCaptionAlign enumerazione . Nella tabella seguente sono elencati i valori possibili.

Valore Descrizione
TableCaptionAlign.Bottom L'elemento didascalia è allineato alla parte inferiore della tabella.
TableCaptionAlign.Left L'elemento didascalia è allineato alla parte sinistra della tabella.
TableCaptionAlign.NotSet L'allineamento dell'elemento della didascalia non è impostato.
TableCaptionAlign.Right L'elemento didascalia è allineato alla parte destra della tabella.
TableCaptionAlign.Top L'elemento didascalia è allineato alla parte superiore della tabella.

Il supporto aggiuntivo per l'accessibilità per il DetailsView controllo viene fornito dalla Caption proprietà . Utilizzare la Caption proprietà per specificare il testo di cui eseguire il rendering in un elemento didascalia HTML in un DetailsView controllo .

Il valore di viene archiviato nello stato di CaptionAlign visualizzazione.

Si applica a

Vedi anche