FormView.CaptionAlign Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die horizontale oder vertikale Position des HTML-Beschriftungselements in einem FormView-Steuerelement ab oder legt sie fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.

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

Eigenschaftswert

TableCaptionAlign

Einer der TableCaptionAlign-Werte. Der Standardwert ist TableCaptionAlign.NotSet.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Wert ist keiner der TableCaptionAlign-Enumerationswerte.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Die Eigenschaft verwendet CaptionAlign wird, um anzugeben, dass das HTML-Beschriftungselement in einem FormView Steuerelement auf der linken Seite des Steuerelements gerendert werden soll.


<%@ 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>

Hinweise

Verwenden Sie die CaptionAlign Eigenschaft, um die horizontale oder vertikale Position des HTML-Beschriftungselements in einem FormView Steuerelement anzugeben. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.

Diese Eigenschaft wird mithilfe eines der TableCaptionAlign Aufzählungswerte festgelegt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert BESCHREIBUNG
TableCaptionAlign.Bottom Das Beschriftungselement wird am unteren Tabellenrand ausgerichtet.
TableCaptionAlign.Left Das Beschriftungselement wird an der linken Seite der Tabelle ausgerichtet.
TableCaptionAlign.NotSet Die Ausrichtung des Beschriftungselements ist nicht festgelegt.
TableCaptionAlign.Right Das Beschriftungselement wird an der rechten Seite der Tabelle ausgerichtet.
TableCaptionAlign.Top Das Beschriftungselement wird am oberen Tabellenrand ausgerichtet.

Hinweis

Wenn diese Eigenschaft auf TableCaptionAlign.NotSet"Festgelegt" festgelegt ist, wird der Standardwert des Browsers verwendet.

Zusätzliche Barrierefreiheitsunterstützung für das Steuerelement wird von der FormView Caption Eigenschaft bereitgestellt. Verwenden Sie die Caption Eigenschaft, um den Text anzugeben, der in einem HTML-Beschriftungselement in einem FormView Steuerelement gerendert werden soll.

Gilt für

Siehe auch