GridView.CaptionAlign プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
GridView コントロールの HTML キャプション要素の水平位置または垂直位置を取得または設定します。 このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。
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, setPublic Overridable Property CaptionAlign As TableCaptionAlignプロパティ値
TableCaptionAlign 値のいずれか 1 つ。 既定値は TableCaptionAlign.NotSet で、ブラウザーの既定の設定が使用されます。
例外
指定した値が TableCaptionAlign 列挙値ではありません。
例
次の例では、プロパティを CaptionAlign 使用して、コントロールの caption 要素 GridView がコントロールの上部に揃うように指定する方法を示します。
<%@ 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 指定します。 このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。
このプロパティは、列挙値のいずれかを使用して設定されます TableCaptionAlign 。 次の表に、使用可能な値の一覧を示します。
| 値 | 説明 |
|---|---|
TableCaptionAlign.Bottom |
キャプション要素は、テーブルの下部に揃えて配置されます。 |
TableCaptionAlign.Left |
キャプション要素は、テーブルの左側に揃えて配置されます。 |
TableCaptionAlign.NotSet |
caption 要素の配置が設定されていません。 |
TableCaptionAlign.Right |
キャプション要素は、テーブルの右側に揃えて配置されます。 |
TableCaptionAlign.Top |
キャプション要素は、テーブルの上部に揃えて配置されます。 |
注意
このプロパティを TableCaptionAlign.NotSet設定すると、ブラウザーの既定値が使用されます。
HTML キャプション要素のテキストを指定するには、プロパティを Caption 使用します。