Condividi tramite

FormView.CaptionAlign Proprietà

Definizione

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

Ottiene o imposta la posizione orizzontale o verticale dell'elemento della didascalia HTML in un FormView controllo . Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi di assistive technology.

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 è uno dei TableCaptionAlign valori di enumerazione.

Esempio

Nell'esempio seguente viene illustrato come utilizzare la CaptionAlign proprietà per specificare che il rendering dell'elemento della didascalia HTML in un FormView 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>FormView Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView Caption and CaptionAlign Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        caption="Employee Details"
        captionalign="Left"  
        runat="server">
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate>
          
        <pagersettings position="Bottom"
          mode="NextPrevious"/> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </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>FormView Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView Caption and CaptionAlign Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        caption="Employee Details"
        captionalign="Left"  
        runat="server">
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate>
          
        <pagersettings position="Bottom"
          mode="NextPrevious"/> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Commenti

Utilizzare la CaptionAlign proprietà per specificare la posizione orizzontale o verticale dell'elemento della didascalia HTML in un FormView controllo . Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi di assistive technology.

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

Valore Descrizione
TableCaptionAlign.Bottom L'elemento della didascalia è allineato alla parte inferiore della tabella.
TableCaptionAlign.Left L'elemento della didascalia è allineato al lato sinistro della tabella.
TableCaptionAlign.NotSet L'allineamento dell'elemento della didascalia non è impostato.
TableCaptionAlign.Right L'elemento caption è allineato al lato destro della tabella.
TableCaptionAlign.Top L'elemento della didascalia è allineato alla parte superiore della tabella.

Annotazioni

Quando questa proprietà è impostata su TableCaptionAlign.NotSet, viene utilizzato il valore predefinito del browser.

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

Si applica a

Vedi anche