FormView.CaptionAlign Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta la posizione orizzontale o verticale dell'elemento didascalia HTML in un controllo FormView. 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 seguente viene illustrato come usare la CaptionAlign proprietà per specificare che l'elemento della didascalia HTML in un FormView controllo deve essere eseguito il rendering 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 didascalia HTML in un FormView controllo. Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi che assistono i disabili.

Questa proprietà è impostata usando 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.

Nota

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

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

Si applica a

Condividi tramite