Bagikan melalui

GridView.CaptionAlign Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur posisi horizontal atau vertikal elemen keterangan HTML dalam GridView kontrol. Properti ini disediakan untuk membuat kontrol lebih mudah diakses oleh pengguna perangkat teknologi bantuan.

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

Nilai Properti

TableCaptionAlign

Salah satu nilai TableCaptionAlign. Defaultnya adalah TableCaptionAlign.NotSet, yang menggunakan pengaturan default browser.

Pengecualian

ArgumentOutOfRangeException

Nilai yang ditentukan bukan salah TableCaptionAlign satu nilai enumerasi.

Contoh

Contoh berikut menunjukkan cara menggunakan CaptionAlign properti untuk menentukan bahwa elemen keterangan untuk GridView kontrol selaras dengan bagian atas kontrol.


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

Keterangan

CaptionAlign Gunakan properti untuk menentukan posisi horizontal atau vertikal elemen keterangan HTML dalam GridView kontrol. Properti ini disediakan untuk membuat kontrol lebih mudah diakses oleh pengguna perangkat teknologi bantuan.

Properti ini diatur menggunakan salah TableCaptionAlign satu nilai enumerasi. Tabel berikut ini mencantumkan nilai yang mungkin.

Nilai Deskripsi
TableCaptionAlign.Bottom Elemen keterangan diselaraskan dengan bagian bawah tabel.
TableCaptionAlign.Left Elemen keterangan diselaraskan dengan sisi kiri tabel.
TableCaptionAlign.NotSet Perataan elemen keterangan tidak diatur.
TableCaptionAlign.Right Elemen keterangan diselaraskan dengan sisi kanan tabel.
TableCaptionAlign.Top Elemen keterangan diselaraskan dengan bagian atas tabel.

Nota

Ketika properti ini diatur ke TableCaptionAlign.NotSet, nilai default browser digunakan.

Untuk menentukan teks untuk elemen keterangan HTML, gunakan Caption properti .

Berlaku untuk

Lihat juga