CheckBoxField クラス

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

データバインドコントロール内にチェックボックスとして表示される Boolean フィールドを表します。

public ref class CheckBoxField : System::Web::UI::WebControls::BoundField

public class CheckBoxField : System.Web.UI.WebControls.BoundField

type CheckBoxField = class
    inherit BoundField

Public Class CheckBoxField
Inherits BoundField

継承: Object

DataControlField

BoundField
CheckBoxField

例

次のコード例では、コントロール内のGridViewオブジェクトをCheckBoxField使用して、ブール型のデータ型を持つMicrosoft SQL Server データソースのフィールドを表示する方法を示します。


<%@ 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>CheckBoxField Example</title>
</head>
<body>
    <form id="form1" 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="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>CheckBoxField Example</title>
</head>
<body>
    <form id="form1" 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>

注釈

このCheckBoxFieldクラスは、チェックボックスにブール型のデータフィールドの値を表示するために、データバインドコントロール (などGridView DetailsView) によって使用されます。オブジェクトは CheckBoxField 、使用されているデータバインドコントロールによって異なる方法で表示されます。たとえば、コントロールは GridView オブジェクトを CheckBoxField 列として表示し、コントロールはオブジェクトを DetailsView 行として表示します。

注意

データバインドコントロールが編集モードでチェックボックスを含むレコードを表示するまで、チェックボックスは無効 (読み取り専用) です。レコードを編集モードにする方法の詳細については、オブジェクトを含む親コントロールのドキュメントを CheckBoxField 参照してください。

オブジェクトに表示 CheckBoxField するフィールドを指定するには、フィールドの名前で DataField プロパティを設定します。

注意

チェックボックスには選択された状態または選択されていない状態のみを表示できるため、オブジェクトはブール CheckBoxField 型のフィールドまたは解析 Parse可能な文字列を持つフィールドにのみバインドできます。

プロパティを設定すると、各チェックボックスの横にキャプションを Text 表示できます。 CheckBoxFieldプロパティがに設定falseされている場合、オブジェクトはデータバインドコントロールでVisible非表示になります。フィールドの値が編集モードで変更されないようにするには、プロパティtrueを ReadOnly . In data-bound controls that support inserting records (such as the DetailsView control), you can hide a CheckBoxField object in insert mode by setting the InsertVisible property to false.

オブジェクトのヘッダーセクションとフッターセクションを CheckBoxField カスタマイズできます。ヘッダーセクションまたはフッターセクションにキャプションを表示するには、それぞれプロパティをHeaderText FooterText設定します。ヘッダーセクションにテキストを表示する代わりに、プロパティを設定して画像を HeaderImageUrl 表示できます。ヘッダーセクションは、プロパティfalseをにCheckBoxField設定することで、オブジェクト内でShowHeader非表示にすることができます。

注意

一部のデータバインドコントロール (コントロールなど) では、コントロールの GridView ヘッダーセクション全体のみを表示または非表示にすることができます。これらのデータバインドコントロールは、個々のバインドされたフィールドの ShowHeader プロパティをサポートしていません。データバインドコントロールのヘッダーセクション全体を表示または非表示にするには (使用可能な場合)、コントロールの ShowHeader プロパティを使用します。

また、フィールドのさまざまな部分のスタイルプロパティを CheckBoxField 設定することで、オブジェクトの外観 (フォントの色、背景色など) をカスタマイズすることもできます。次の表に、さまざまなスタイルプロパティを示します。

Style プロパティ	[説明]
ControlStyle	オブジェクトの子 Web サーバーコントロールの CheckBoxField スタイル設定。
FooterStyle	オブジェクトのフッターセクションの CheckBoxField スタイル設定。
HeaderStyle	オブジェクトのヘッダーセクションの CheckBoxField スタイル設定。
ItemStyle	オブジェクト内 CheckBoxField のデータ項目のスタイル設定。

コンストラクター

CheckBoxField()

CheckBoxField クラスの新しいインスタンスを初期化します。

プロパティ

AccessibleHeaderText	一部のコントロールの `AbbreviatedText` プロパティ値として表示されるテキストを取得または設定します。 (継承元 DataControlField)
ApplyFormatInEditMode	ApplyFormatInEditMode プロパティをオーバーライドします。このプロパティは CheckBoxField クラスではサポートされていません。
Control	DataControlField オブジェクトが関連付けられているデータコントロールの参照を取得します。 (継承元 DataControlField)
ControlStyle	DataControlField オブジェクトに格納されているすべての Web サーバーコントロールのスタイルを取得します。 (継承元 DataControlField)
ConvertEmptyStringToNull	ConvertEmptyStringToNull プロパティをオーバーライドします。このプロパティは CheckBoxField クラスではサポートされていません。
DataField	CheckBoxField オブジェクトにバインドするデータフィールドの名前を取得または設定します。
DataFormatString	フィールドの値の表示形式を指定する文字列を取得または設定します。このプロパティは CheckBoxField クラスではサポートされていません。
DesignMode	デザイン時環境で、現在データコントロールフィールドが表示されているかどうかを示す値を取得します。 (継承元 DataControlField)
FooterStyle	データコントロールフィールドのフッターのスタイルを取得または設定します。 (継承元 DataControlField)
FooterText	データコントロールフィールドのフッター項目に表示されるテキストを取得または設定します。 (継承元 DataControlField)
HeaderImageUrl	データコントロールフィールドのヘッダー項目に表示されるイメージの URL を取得または設定します。 (継承元 DataControlField)
HeaderStyle	データコントロールフィールドのヘッダーのスタイルを取得または設定します。 (継承元 DataControlField)
HeaderText	データコントロールのヘッダーに表示するテキストを取得または設定します。 (継承元 BoundField)
HtmlEncode	HtmlEncode プロパティをオーバーライドします。このプロパティは CheckBoxField クラスではサポートされていません。
HtmlEncodeFormatString	書式設定されたテキストを表示する前に、そのテキストを HTML エンコードするかどうかを示す値を取得または設定します。
InsertVisible	DataControlField オブジェクトの親データバインドコントロールが挿入モードの場合に、このオブジェクトが表示されるかどうかを示す値を取得します。 (継承元 DataControlField)
IsTrackingViewState	DataControlField オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 (継承元 DataControlField)
ItemStyle	データコントロールフィールドで表示されるテキストベースの内容のスタイルを取得します。 (継承元 DataControlField)
NullDisplayText	フィールドの値が `null` の場合に、そのフィールドに表示するテキストを取得または設定します。このプロパティは CheckBoxField クラスではサポートされていません。
ReadOnly	編集モードでフィールドの値を変更できるかどうかを示す値を取得または設定します。 (継承元 BoundField)
ShowHeader	データコントロールフィールドのヘッダー項目を表示するかどうかを示す値を取得または設定します。 (継承元 DataControlField)
SortExpression	データソースコントロールでデータを並べ替えるために使用される並べ替え式を、取得または設定します。 (継承元 DataControlField)
SupportsHtmlEncode	コントロールが HTML エンコーディングをサポートしているかどうか示すブール値を取得します。
Text	CheckBoxField オブジェクトの各チェックボックスの横に表示されるキャプションを取得または設定します。
ValidateRequestMode	コントロールがクライアントの入力を検証するかどうかを決定する値を取得または設定します。 (継承元 BoundField)
ViewState	同一のページに対する複数の要求にわたって、DataControlField オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 (継承元 DataControlField)
Visible	データコントロールフィールドを表示するかどうかを示す値を取得または設定します。 (継承元 DataControlField)

メソッド

CloneField()	現在の DataControlField 派生オブジェクトのコピーを作成します。 (継承元 DataControlField)
CopyProperties(DataControlField)	CheckBoxField オブジェクトの現在のプロパティを、指定された DataControlField オブジェクトにコピーします。
CreateField()	空の CheckBoxField オブジェクトを作成します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	指定した IDictionary オブジェクトに、指定した DataControlFieldCell オブジェクトの値を読み込みます。
FormatDataValue(Object, Boolean)	BoundField オブジェクトのセルの指定したフィールド値を書式変換します。 (継承元 BoundField)
GetDesignTimeValue()	CheckBoxField オブジェクトがデザイナーに表示されるときに、フィールドの値として使用される値を取得します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValue(Control)	BoundField オブジェクトにバインドされているフィールドの値を取得します。 (継承元 BoundField)
Initialize(Boolean, Control)	BoundField オブジェクトを初期化します。 (継承元 BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	指定された TableCell オブジェクトを、指定された行の状態に初期化します。 (継承元 BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	指定された DataControlFieldCell オブジェクトを、指定された行の状態に初期化します。
LoadViewState(Object)	このフィールドの、以前保存したビューステート情報を復元します。 (継承元 BoundField)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnDataBindField(Object, EventArgs)	フィールドの値を CheckBoxField オブジェクトのチェックボックスにバインドします。
OnFieldChanged()	`FieldChanged` イベントを発生させます。 (継承元 DataControlField)
SaveViewState()	ページがサーバーにポストバックされた時間以降に発生した、DataControlField ビューステートへの変更を保存します。 (継承元 DataControlField)
ToString()	この DataControlField オブジェクトを表す文字列を返します。 (継承元 DataControlField)
TrackViewState()	DataControlField オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState プロパティに格納して、同じページに対する複数の要求にわたって永続化できます。 (継承元 DataControlField)
ValidateSupportsCallback()	CheckBoxField オブジェクトに格納されているコントロールがコールバックをサポートしているかどうかを確認します。

明示的なインターフェイスの実装

IDataSourceViewSchemaAccessor.DataSourceViewSchema	DataControlField オブジェクトに関連付けられているスキーマを取得または設定します。 (継承元 DataControlField)
IStateManager.IsTrackingViewState	DataControlField オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 (継承元 DataControlField)
IStateManager.LoadViewState(Object)	データコントロールフィールドの、以前保存したビューステートを復元します。 (継承元 DataControlField)
IStateManager.SaveViewState()	ページがサーバーにポストバックされた時間以降に発生した、DataControlField ビューステートへの変更を保存します。 (継承元 DataControlField)
IStateManager.TrackViewState()	DataControlField オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState プロパティに格納して、同じページに対する複数の要求にわたって永続化できます。 (継承元 DataControlField)

適用対象

次の方法で共有