AutoGeneratedField クラス

定義

データ バインドされたコントロール内の自動生成されたフィールドを表します。 このクラスは継承できません。

public ref class AutoGeneratedField sealed : System::Web::UI::WebControls::BoundField
public sealed class AutoGeneratedField : System.Web.UI.WebControls.BoundField
type AutoGeneratedField = class
    inherit BoundField
Public NotInheritable Class AutoGeneratedField
Inherits BoundField
継承
AutoGeneratedField

次の例では、コントロールから派生する AutoGeneratedField カスタム コントロールの オブジェクトを作成する方法を DetailsView 示します。


using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;
using System.Web;

namespace Samples.AspNet.CS.Controls
{

    [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)]
    public class SimpleCustomControl : DetailsView
    {

        protected override AutoGeneratedField CreateAutoGeneratedRow(AutoGeneratedFieldProperties fieldProperties)
        {

            // Create an AutoGeneratedField object.
            AutoGeneratedField field = new AutoGeneratedField(fieldProperties.DataField);

            // Set the properties of the AutoGeneratedField using
            // the values from the AutoGeneratedFieldProperties
            // object contained in the fieldProperties parameter.
            ((IStateManager)field).TrackViewState();
            field.HeaderText = fieldProperties.Name;
            field.SortExpression = fieldProperties.Name;
            field.ReadOnly = fieldProperties.IsReadOnly;
            field.DataType = fieldProperties.Type;

            return field;
        }
    }
}

Imports System.ComponentModel
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Imports System.Web

Namespace Samples.AspNet.VB.Controls

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal), AspNetHostingPermission(SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> Public Class SimpleCustomControl
        Inherits System.Web.UI.WebControls.DetailsView

        Protected Overrides Function CreateAutoGeneratedRow(ByVal fieldProperties As AutoGeneratedFieldProperties) As AutoGeneratedField

            ' Create an AutoGeneratedField object.
            Dim field As New AutoGeneratedField(fieldProperties.DataField)

            ' Set the properties of the AutoGeneratedField using
            ' the values from the AutoGeneratedFieldProperties 
            ' object contained in the fieldProperties parameter.
            CType(field, IStateManager).TrackViewState()
            field.HeaderText = fieldProperties.Name
            field.SortExpression = fieldProperties.Name
            field.ReadOnly = fieldProperties.IsReadOnly
            field.DataType = fieldProperties.Type

            Return field

        End Function

    End Class

End Namespace

注釈

クラスはAutoGeneratedField、 や DetailsViewなどのGridViewデータ バインド コントロールで自動的に生成されるフィールドを表すために使用されます。 自動的に生成されるフィールドは、適切なプロパティが に true 設定されている場合に、データ バインド コントロールによって作成されます (たとえば、 AutoGenerateColumns コントロールの GridView プロパティ、 AutoGenerateRows コントロールの DetailsView プロパティなど)。

注意

自動生成されたフィールドは、データ バインド コントロールのフィールド コレクション (コントロールのコレクション、ColumnsFieldsコントロールのコレクションGridViewDetailsViewなど) には追加されません。

クラスは AutoGeneratedField 、データ バインド コントロールによって内部的に使用することを目的としています。 他のデータ フィールド (、CheckBoxFieldTemplateField、などBoundField) AutoGeneratedField とは異なり、クラスをフィールド コレクションの一部としてページに宣言的に配置することはできません。 フィールド コレクションにオブジェクトを AutoGeneratedField プログラムで追加することはできますが、この設計パターンは避ける必要があります。

自動的に生成されるフィールドはフィールドの自動レンダリングを表すので、データ バインド コントロールでは通常、ユーザーがオブジェクトの AutoGeneratedField プロパティを変更することはできません。 自動レンダリングがニーズに適していない場合は、コントロールのフィールド コレクションに独自のデータ フィールドを定義します。

コンストラクター

AutoGeneratedField(String)

データ フィールドを指定して、AutoGeneratedField クラスの新しいインスタンスを初期化します。

プロパティ

AccessibleHeaderText

一部のコントロールの AbbreviatedText プロパティ値として表示されるテキストを取得または設定します。

(継承元 DataControlField)
ApplyFormatInEditMode

DataFormatString オブジェクトを格納しているデータ バインド コントロールが編集モードである場合に、BoundField プロパティで指定した書式指定文字列をフィールド値に適用するかどうかを示す値を取得または設定します。

(継承元 BoundField)
Control

DataControlField オブジェクトが関連付けられているデータ コントロールの参照を取得します。

(継承元 DataControlField)
ControlStyle

DataControlField オブジェクトに格納されているすべての Web サーバー コントロールのスタイルを取得します。

(継承元 DataControlField)
ConvertEmptyStringToNull

データ ソースからフィールドを取得するときに空の文字列 ("") 値が null に変換されるかどうかを示す値を取得または設定します。

DataField

BoundField オブジェクトにバインドするデータ フィールドの名前を取得または設定します。

(継承元 BoundField)
DataFormatString

AutoGeneratedField オブジェクトの各イメージの代替テキストの表示書式を指定する文字列を取得または設定します。

DataType

AutoGeneratedField オブジェクト内に表示される値のデータ型を取得または設定します。

DesignMode

デザイン時環境で、現在データ コントロール フィールドが表示されているかどうかを示す値を取得します。

(継承元 DataControlField)
FooterStyle

データ コントロール フィールドのフッターのスタイルを取得または設定します。

(継承元 DataControlField)
FooterText

データ コントロール フィールドのフッター項目に表示されるテキストを取得または設定します。

(継承元 DataControlField)
HeaderImageUrl

データ コントロール フィールドのヘッダー項目に表示されるイメージの URL を取得または設定します。

(継承元 DataControlField)
HeaderStyle

データ コントロール フィールドのヘッダーのスタイルを取得または設定します。

(継承元 DataControlField)
HeaderText

データ コントロールのヘッダーに表示するテキストを取得または設定します。

(継承元 BoundField)
HtmlEncode

フィールド値を BoundField オブジェクトに表示する前に HTML エンコードするかどうかを示す値を取得または設定します。

(継承元 BoundField)
HtmlEncodeFormatString

DataFormatString プロパティを BoundField 値に適用することで作成されるテキストを表示するときに、HTML エンコードするかどうかを示す値を取得または設定します。

(継承元 BoundField)
InsertVisible

挿入モードの場合に AutoGeneratedField オブジェクトが表示されるかどうかを示す値を取得または設定します。

IsTrackingViewState

DataControlField オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。

(継承元 DataControlField)
ItemStyle

データ コントロール フィールドで表示されるテキスト ベースの内容のスタイルを取得します。

(継承元 DataControlField)
NullDisplayText

フィールド値が null の場合にフィールドに表示するキャプションを取得または設定します。

(継承元 BoundField)
ReadOnly

編集モードでフィールドの値を変更できるかどうかを示す値を取得または設定します。

(継承元 BoundField)
ShowHeader

データ コントロール フィールドのヘッダー項目を表示するかどうかを示す値を取得または設定します。

(継承元 DataControlField)
SortExpression

データ ソース コントロールでデータを並べ替えるために使用される並べ替え式を、取得または設定します。

(継承元 DataControlField)
SupportsHtmlEncode

BoundField オブジェクトで HTML エンコーディングがサポートされるかどうかを示す値を取得します。

(継承元 BoundField)
ValidateRequestMode

コントロールがクライアントの入力を検証するかどうかを決定する値を取得または設定します。

(継承元 BoundField)
ViewState

同一のページに対する複数の要求にわたって、DataControlField オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。

(継承元 DataControlField)
Visible

データ コントロール フィールドを表示するかどうかを示す値を取得または設定します。

(継承元 DataControlField)

メソッド

CloneField()

現在の DataControlField 派生オブジェクトのコピーを作成します。

(継承元 DataControlField)
CopyProperties(DataControlField)

BoundField オブジェクトの現在のプロパティを、指定された DataControlField オブジェクトにコピーします。

(継承元 BoundField)
CreateField()

空の BoundField オブジェクトを作成します。

(継承元 BoundField)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

指定した IOrderedDictionary オブジェクトに、指定した DataControlFieldCell オブジェクトの値を読み込みます。

FormatDataValue(Object, Boolean)

BoundField オブジェクトのセルの指定したフィールド値を書式変換します。

(継承元 BoundField)
GetDesignTimeValue()

デザイナーで BoundField オブジェクトを表示するときにフィールド値に使用される値を取得します。

(継承元 BoundField)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
GetValue(Control)

BoundField オブジェクトにバインドされているフィールドの値を取得します。

(継承元 BoundField)
Initialize(Boolean, Control)

BoundField オブジェクトを初期化します。

(継承元 BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

指定された TableCell オブジェクトを、指定された行の状態に初期化します。

(継承元 BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

指定された TableCell オブジェクトを、指定された行の状態に初期化します。

(継承元 BoundField)
LoadViewState(Object)

このフィールドの、以前保存したビューステート情報を復元します。

(継承元 BoundField)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnDataBindField(Object, EventArgs)

BoundField オブジェクトのフィールドの値をバインドします。

(継承元 BoundField)
OnFieldChanged()

FieldChanged イベントを発生させます。

(継承元 DataControlField)
SaveViewState()

ページがサーバーにポストバックされた時間以降に発生した、DataControlField ビューステートへの変更を保存します。

(継承元 DataControlField)
ToString()

この DataControlField オブジェクトを表す文字列を返します。

(継承元 DataControlField)
TrackViewState()

DataControlField オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState プロパティに格納して、同じページに対する複数の要求にわたって永続化できます。

(継承元 DataControlField)
ValidateSupportsCallback()

AutoGeneratedField オブジェクトに格納されているコントロールがコールバックをサポートしているかどうかを確認します。

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

IDataSourceViewSchemaAccessor.DataSourceViewSchema

DataControlField オブジェクトに関連付けられているスキーマを取得または設定します。

(継承元 DataControlField)
IStateManager.IsTrackingViewState

DataControlField オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。

(継承元 DataControlField)
IStateManager.LoadViewState(Object)

データ コントロール フィールドの、以前保存したビューステートを復元します。

(継承元 DataControlField)
IStateManager.SaveViewState()

ページがサーバーにポストバックされた時間以降に発生した、DataControlField ビューステートへの変更を保存します。

(継承元 DataControlField)
IStateManager.TrackViewState()

DataControlField オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState プロパティに格納して、同じページに対する複数の要求にわたって永続化できます。

(継承元 DataControlField)

適用対象

こちらもご覧ください