CheckBoxField クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説CheckBoxField クラスは、データ バインド コントロール (GridView、DetailsView など) が、ブール値データ フィールドの値をチェック ボックスに表示するために使用します。CheckBoxField オブジェクトは、そのオブジェクトを使用しているデータ バインド コントロールにより異なった形式で表示されます。たとえば、CheckBoxField オブジェクトは、GridView コントロールでは列として表示され、DetailsView コントロールでは行として表示されます。
.gif) メモ |
|---|
| データ バインド コントロールがチェック ボックスを含むレコードを編集モードで表示するまで、チェック ボックスは無効です (読み取り専用)。レコードを編集モードにする方法の詳細については、CheckBoxField オブジェクトを含む親コントロールのドキュメントを参照してください。 |
CheckBoxField オブジェクトに表示するフィールドを指定するには、DataField プロパティにフィールドの名前を設定します。
| メモ |
|---|
| チェック ボックスでは、選択された状態と選択されていない状態しか表示できないので、CheckBoxField オブジェクトは、Parse で解析できるブール型または文字列のフィールドにしかバインドできません。 |
Text プロパティを設定すると、各チェック ボックスの横にキャプションを表示できます。Visible プロパティに false を設定すると、データ バインド コントロールで CheckBoxField オブジェクトを非表示にできます。編集モードでフィールドの値の変更を不許可にするには、ReadOnly プロパティに true を設定します。レコードの挿入をサポートしているデータ バインド コントロール (DetailsView コントロールなど) では、InsertVisible プロパティに false を設定することで、編集モードで CheckBoxField オブジェクトを非表示にできます。
また、CheckBoxField オブジェクトのヘッダー セクションおよびフッター セクションをカスタマイズできます。ヘッダー セクションまたはフッター セクションのキャプションを表示するには、HeaderText または FooterText プロパティを設定します。HeaderImageUrl プロパティを設定すると、ヘッダー セクションにテキストの代わりにイメージを表示できます。ShowHeader プロパティに false を設定すると、CheckBoxField オブジェクトでヘッダー セクションを非表示にできます。
| メモ |
|---|
| 一部のデータ バインド コントロール (GridView コントロールなど) では、コントロールのヘッダー セクションをすべて表示するか、すべて非表示にするかしかできません。これらのデータ バインド コントロールは、個々のバインド フィールドの ShowHeader プロパティはサポートしていません。データ バインド コントロールのヘッダー セクション (存在する場合) 全体を表示または非表示にするには、コントロールの ShowHeader プロパティを使用します。 |
また、フィールドの各部分にスタイル プロパティを設定すると、CheckBoxField オブジェクトの外観 (フォントの色や背景色など) をカスタマイズできます。さまざまなスタイル プロパティの一覧を次の表に示します。
使用例次のコード例では、GridView コントロールで CheckBoxField オブジェクトを使用して、Microsoft SQL Server データ ソースのフィールドをブール型で表示する方法を示します。
<%@ Page language="VB" %> <html> <body> <form runat="server"> <h3>CheckBoxField Example</h3> <asp:gridview id="AuthorsGridView" datasourceid="AuthorsSqlDataSource" autogeneratecolumns="False" runat="server"> <columns> <asp:boundfield datafield="au_lname" headertext="Last Name"/> <asp:checkboxfield datafield="contract" text="Contract" headertext="Contract"/> </columns> </asp:gridview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Pubs sample database. --> <asp:sqldatasource id="AuthorsSqlDataSource" selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]" connectionstring="server=localhost;database=pubs;integrated security=SSPI" runat="server"> </asp:sqldatasource> </form> </body> </html>
<%@ Page language="C#" %> <html> <body> <form runat="server"> <h3>CheckBoxField Example</h3> <asp:gridview id="AuthorsGridView" datasourceid="AuthorsSqlDataSource" autogeneratecolumns="False" runat="server"> <columns> <asp:boundfield datafield="au_lname" headertext="Last Name"/> <asp:checkboxfield datafield="contract" text="Contract" headertext="Contract"/> </columns> </asp:gridview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Pubs sample database. --> <asp:sqldatasource id="AuthorsSqlDataSource" selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]" connectionstring="server=localhost;database=pubs;integrated security=SSPI" runat="server"> </asp:sqldatasource> </form> </body> </html>
.NET Framework のセキュリティ継承階層System.Web.UI.WebControls.DataControlField
System.Web.UI.WebControls.BoundField
System.Web.UI.WebControls.CheckBoxField
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からCheckBoxField クラスを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からCheckBoxField クラスを検索 - CheckBoxField クラスのページへのリンク
