Udostępnij za pośrednictwem

GridView.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 GridView . 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, która używa domyślnego ustawienia przeglądarki.

Wyjątki

ArgumentOutOfRangeException

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

Przykłady

W poniższym przykładzie pokazano, jak za pomocą CaptionAlign właściwości określić, że element podpisu dla GridView kontrolki jest wyrównany do góry 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>GridView Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Caption and CaptionAlign Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true"
        caption="Customer Information Table"
        captionalign="Top"   
        runat="server">                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        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>GridView Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Caption and CaptionAlign Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true"
        caption="Customer Information Table"
        captionalign="Top"   
        runat="server">                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </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 pionieGridView. 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.

Uwaga

Gdy ta właściwość jest ustawiona na TableCaptionAlign.NotSetwartość , zostanie użyta wartość domyślna przeglądarki.

Aby określić tekst elementu podpisu HTML, użyj Caption właściwości .

Dotyczy

Zobacz też