Aracılığıyla paylaş

GridView.CaptionAlign Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimdeki HTML resim yazısı öğesinin GridView yatay veya dikey konumunu alır veya ayarlar. Bu özellik, denetimi yardımcı teknoloji cihazlarının kullanıcıları için daha erişilebilir hale getirmek için sağlanır.

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

Özellik Değeri

TableCaptionAlign

Değerlerden TableCaptionAlign biri. Varsayılan ayar, tarayıcının varsayılan ayarını kullanan değeridir TableCaptionAlign.NotSet.

Özel durumlar

ArgumentOutOfRangeException

Belirtilen değer numaralandırma değerlerinden TableCaptionAlign biri değil.

Örnekler

Aşağıdaki örnekte, denetimin GridView caption öğesinin CaptionAlign denetimin üst kısmıyla hizalandığını belirtmek için özelliğinin nasıl kullanılacağı gösterilmektedir.


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

Açıklamalar

Bir denetimdeki CaptionAlign HTML resim yazısı öğesinin GridView yatay veya dikey konumunu belirtmek için özelliğini kullanın. Bu özellik, denetimi yardımcı teknoloji cihazlarının kullanıcıları için daha erişilebilir hale getirmek için sağlanır.

Bu özellik, numaralandırma değerlerinden TableCaptionAlign biri kullanılarak ayarlanır. Aşağıdaki tabloda olası değerler listelemektedir.

Değer Açıklama
TableCaptionAlign.Bottom Resim yazısı öğesi tablonun alt kısmıyla hizalanır.
TableCaptionAlign.Left Resim yazısı öğesi tablonun sol tarafına hizalanır.
TableCaptionAlign.NotSet Resim yazısı öğesinin hizalaması ayarlanmadı.
TableCaptionAlign.Right Resim yazısı öğesi tablonun sağ tarafına hizalanır.
TableCaptionAlign.Top Resim yazısı öğesi tablonun üst kısmıyla hizalanır.

Uyarı

Bu özellik olarak TableCaptionAlign.NotSetayarlandığında, tarayıcının varsayılan değeri kullanılır.

HTML resim yazısı öğesinin metnini belirtmek için özelliğini kullanın Caption .

Şunlara uygulanır

Ayrıca bkz.