FormView.CaptionAlign Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der horizontalen oder vertikalen Position des HTML-Beschriftungselements in einem FormView Steuerelement. Diese Eigenschaft wird bereitgestellt, um die Steuerung für Benutzer von Hilfstechnologiegeräten zugänglicher zu machen.
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, setPublic Overridable Property CaptionAlign As TableCaptionAlignEigenschaftswert
Einer der TableCaptionAlign Werte. Der Standardwert lautet TableCaptionAlign.NotSet.
Ausnahmen
Der angegebene Wert ist keiner der TableCaptionAlign Enumerationswerte.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die CaptionAlign Eigenschaft verwendet 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 die Steuerung für Benutzer von Hilfstechnologiegeräten zugänglicher zu machen.
Diese Eigenschaft wird mit einem der TableCaptionAlign Enumerationswerte festgelegt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.
| Wert | Beschreibung |
|---|---|
TableCaptionAlign.Bottom |
Das Caption-Element wird am unteren Rand der Tabelle ausgerichtet. |
TableCaptionAlign.Left |
Das Caption-Element wird an der linken Seite der Tabelle ausgerichtet. |
TableCaptionAlign.NotSet |
Die Ausrichtung des Beschriftungselements ist nicht festgelegt. |
TableCaptionAlign.Right |
Das Caption-Element wird an der rechten Seite der Tabelle ausgerichtet. |
TableCaptionAlign.Top |
Das Caption-Element wird am Oberen Rand der Tabelle ausgerichtet. |
Hinweis
Wenn diese Eigenschaft auf TableCaptionAlign.NotSet festgelegt ist, wird der Standardwert des Browsers verwendet.
Zusätzliche Barrierefreiheitsunterstützung für das FormView Steuerelement wird von der Caption Eigenschaft bereitgestellt. Verwenden Sie die Caption Eigenschaft, um den Text anzugeben, der in einem HTML-Beschriftungselement in einem FormView Steuerelement gerendert werden soll.
