DetailsView.CaptionAlign Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia położenie w poziomie lub w pionie elementu podpisu HTML w kontrolce DetailsView . Ta właściwość jest udostępniana w celu zwiększenia dostępności kontroli dla użytkowników urządzeń z technologią pomocniczą.

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

Wartość właściwości

TableCaptionAlign

TableCaptionAlign Jedna z wartości. Wartość domyślna to TableCaptionAlign.NotSet.

Wyjątki

ArgumentOutOfRangeException

Określona wartość nie jest jedną z TableCaptionAlign wartości wyliczenia.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą CaptionAlign właściwości określić, że element podpisu HTML w kontrolce DetailsView powinien być renderowany po lewej stronie kontrolki.


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

Uwagi

CaptionAlign Użyj właściwości , aby określić położenie elementu podpisu HTML w kontrolce w poziomie lub w pionieDetailsView. Ta właściwość jest udostępniana w celu zwiększenia dostępności kontroli dla użytkowników urządzeń z technologią pomocniczą.

Ta właściwość jest ustawiana przy użyciu jednej z TableCaptionAlign wartości wyliczenia. W poniższej tabeli wymieniono możliwe wartości.

Wartość Opis
TableCaptionAlign.Bottom Element podpisu jest wyrównany do dołu tabeli.
TableCaptionAlign.Left Element podpisu jest wyrównany do lewej strony tabeli.
TableCaptionAlign.NotSet Wyrównanie elementu podpisu nie jest ustawione.
TableCaptionAlign.Right Element podpisu jest wyrównany do prawej strony tabeli.
TableCaptionAlign.Top Element podpisu jest wyrównany do góry tabeli.

Dodatkowa obsługa ułatwień dostępu dla kontrolki DetailsView jest zapewniana Caption przez właściwość . Caption Użyj właściwości , aby określić tekst do renderowania w elemecie podpisu HTML w kontrolceDetailsView.

Wartość jest CaptionAlign przechowywana w stanie widoku.

Dotyczy

Zobacz też