GridView.CaptionAlign プロパティ

定義

GridView コントロールの HTML キャプション要素の水平位置または垂直位置を取得または設定します。Gets or sets the horizontal or vertical position of the HTML caption element in a GridView control. このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。This property is provided to make the control more accessible to users of assistive technology devices.

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

プロパティ値

TableCaptionAlign

TableCaptionAlign 値のいずれか 1 つ。One of the TableCaptionAlign values. 既定値は TableCaptionAlign.NotSet で、ブラウザーの既定の設定が使用されます。The default is TableCaptionAlign.NotSet, which uses the browser's default setting.

例外

指定した値が TableCaptionAlign 列挙値ではありません。The specified value is not one of the TableCaptionAlign enumeration values.

次の例では、プロパティを使用して、 CaptionAlign コントロールの caption 要素を GridView コントロールの上部に揃えるように指定する方法を示します。The following example demonstrates how to use the CaptionAlign property to specify that the caption element for a GridView control is aligned with the top of the control.


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

注釈

CaptionAlignコントロールの HTML キャプション要素の水平方向または垂直位置を指定するには、プロパティを使用し GridView ます。Use the CaptionAlign property to specify the horizontal or vertical position of the HTML caption element in a GridView control. このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。This property is provided to make the control more accessible to users of assistive technology devices.

このプロパティは、列挙値のいずれかを使用して設定され TableCaptionAlign ます。This property is set using one of the TableCaptionAlign enumeration values. 次の表に、使用可能な値を示します。The following table lists the possible values.

Value 説明Description
TableCaptionAlign.Bottom キャプション要素は、テーブルの下部に揃えて配置されます。The caption element is aligned with the bottom of the table.
TableCaptionAlign.Left キャプション要素は、テーブルの左側に揃えて配置されます。The caption element is aligned with the left side of the table.
TableCaptionAlign.NotSet キャプション要素のアラインメントが設定されていません。The caption element's alignment is not set.
TableCaptionAlign.Right キャプション要素は、テーブルの右側に揃えて配置されます。The caption element is aligned with the right side of the table.
TableCaptionAlign.Top キャプション要素は、テーブルの上部に揃えて配置されます。The caption element is aligned with the top of the table.

注意

このプロパティがに設定されている場合 TableCaptionAlign.NotSet 、ブラウザーの既定値が使用されます。When this property is set to TableCaptionAlign.NotSet, the default value of the browser is used.

HTML キャプション要素のテキストを指定するには、プロパティを使用し Caption ます。To specify the text for the HTML caption element, use the Caption property.

適用対象

こちらもご覧ください