Freigeben über

DetailsView.CaptionAlign Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen der horizontalen oder vertikalen Position des HTML-Beschriftungselements in einem DetailsView 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, set
Public Overridable Property CaptionAlign As TableCaptionAlign

Eigenschaftswert

TableCaptionAlign

Einer der TableCaptionAlign Werte. Der Standardwert lautet TableCaptionAlign.NotSet.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Wert ist keiner der TableCaptionAlign Enumerationswerte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die CaptionAlign Eigenschaft verwendet wird, um anzugeben, dass das HTML-Caption-Element in einem DetailsView 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>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>

Hinweise

Verwenden Sie die CaptionAlign Eigenschaft, um die horizontale oder vertikale Position des HTML-Beschriftungselements in einem DetailsView 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.

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

Der Wert von wird im Ansichtszustand CaptionAlign gespeichert.

Gilt für:

Weitere Informationen