BoundField クラス

リファレンス

定義

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

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

重要

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

データバインドコントロール内にテキストとして表示されるフィールドを表します。

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

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

type BoundField = class
    inherit DataControlField

Public Class BoundField
Inherits DataControlField

継承: Object

DataControlField
BoundField

派生: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

例

次のコード例は、オブジェクトを BoundField 使用してコントロール内のフィールドの値を表示する方法を 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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

注釈

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

オブジェクトに BoundField 表示するフィールドを指定するには、プロパティを DataField フィールドの名前に設定します。フィールドの値は、プロパティtrueを〗に設定HtmlEncodeして表示する前に HTML エンコードできます。プロパティを設定することで、フィールドの値にユーザー設定の書式設定文字列を DataFormatString 適用できます。プロパティが HtmlEncode 指定されている場合、 trueフィールドのエンコードされた文字列値がカスタム書式指定文字列で使用されます。既定では、書式設定文字列は、データバインドコントロールが読み取り専用モードの場合にのみフィールド値に適用されます。データバインドコントロールが編集モードの間に表示される値に書式設定文字列を適用するには、プロパティtrueを ApplyFormatInEditMode .. フィールドの値が null の場合は、プロパティを設定してカスタムキャプションを NullDisplayText 表示できます。オブジェクトはBoundField、プロパティを > に設定することで、空の文字列 ("") フィールド値を null 値に自動的にConvertEmptyStringToNulltrue変換することもできます。

You can hide a BoundField object in a data-bound control by setting the Visible property to false. フィールドの値が編集モードで変更されないようにするには、プロパティtrueを ReadOnly . In data-bound controls that support inserting records (such as the DetailsView control), you can hide a BoundField object by setting the InsertVisible property to false. これは、通常、自動的に生成されたキーフィールドを挿入モードで非表示にする場合に行われます。

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

注意

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

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

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

コンストラクター

BoundField()

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

フィールド

ThisExpression

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

"this" 式を表します。

プロパティ

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

メソッド

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

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

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

適用対象

次の方法で共有