GridView.CaptionAlign Özellik

  • Başvuru

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 değer, tarayıcının varsayılan ayarını kullanan şeklindedir TableCaptionAlign.NotSet.

Özel durumlar

ArgumentOutOfRangeException

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

Örnekler

Aşağıdaki örnek, bir denetimin caption öğesinin CaptionAlign denetimin en üstüne hizalı olduğunu belirtmek için GridView özelliğinin nasıl kullanılacağını gösterir.


<%@ 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 Caption öğesi tablonun alt kısmıyla hizalanır.
TableCaptionAlign.Left Caption öğesi tablonun sol tarafına hizalanır.
TableCaptionAlign.NotSet Resim yazısı öğesinin hizalaması ayarlanmadı.
TableCaptionAlign.Right Caption öğesi tablonun sağ tarafına hizalanır.
TableCaptionAlign.Top Caption öğesi tablonun üst kısmına hizalanır.

Not

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.