GridView.CaptionAlign Właściwość

Odwołanie

Definicja

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

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Share via