次の方法で共有


CheckBoxField クラス

定義

データ バインド コントロール内にチェック ボックスとして表示される 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
継承

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

注意

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

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

注意

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

プロパティを設定すると、各チェック ボックスの横にキャプションを Text 表示できます。 CheckBoxFieldプロパティが に設定falseされている場合、オブジェクトはデータ バインド コントロールでVisible非表示になります。 フィールドの値が編集モードで変更されないようにするには、プロパティtrueReadOnly . 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 カスタマイズできます。 ヘッダーセクションまたはフッターセクションにキャプションを表示するには、それぞれプロパティをHeaderTextFooterText設定します。 ヘッダー セクションにテキストを表示する代わりに、プロパティを設定して画像を 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)

適用対象

こちらもご覧ください