GridView.CaptionAlign Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger den vågräta eller lodräta positionen för HTML-textelementet i en GridView kontroll. Den här egenskapen tillhandahålls för att göra kontrollen mer tillgänglig för användare av hjälpmedelsteknikenheter.

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

Egenskapsvärde

TableCaptionAlign

Ett av TableCaptionAlign värdena. Standardvärdet är TableCaptionAlign.NotSet, som använder webbläsarens standardinställning.

Undantag

ArgumentOutOfRangeException

Det angivna värdet är inte ett av uppräkningsvärdena TableCaptionAlign .

Exempel

I följande exempel visas hur du använder CaptionAlign egenskapen för att ange att undertextelementet för en GridView kontroll är justerat mot kontrollens överkant.


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

Kommentarer

Använd egenskapen CaptionAlign för att ange den vågräta eller lodräta positionen för HTML-textelementet i en GridView kontroll. Den här egenskapen tillhandahålls för att göra kontrollen mer tillgänglig för användare av hjälpmedelsteknikenheter.

Den här egenskapen anges med ett av uppräkningsvärdena TableCaptionAlign . I följande tabell visas möjliga värden.

Value Description
TableCaptionAlign.Bottom Undertextelementet är justerat mot tabellens nederkant.
TableCaptionAlign.Left Undertextelementet är justerat till vänster i tabellen.
TableCaptionAlign.NotSet Justeringen för textelementet har inte angetts.
TableCaptionAlign.Right Undertextelementet är justerat till höger i tabellen.
TableCaptionAlign.Top Undertextelementet är i linje med tabellens överkant.

Note

När den här egenskapen är inställd TableCaptionAlign.NotSetpå används standardvärdet för webbläsaren.

Om du vill ange texten för HTML-textelementet använder du egenskapen Caption .

Gäller för

Se även