AutoGeneratedField クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ バインドされたコントロール内の自動生成されたフィールドを表します。 このクラスは継承できません。
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 カスタム コントロールの オブジェクトを作成する方法を 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 、データ バインド コントロールによって内部的に使用することを目的としています。 他のデータ フィールド (、CheckBoxField、TemplateField、などBoundField) AutoGeneratedField とは異なり、クラスをフィールド コレクションの一部としてページに宣言的に配置することはできません。 フィールド コレクションにオブジェクトを AutoGeneratedField プログラムで追加することはできますが、この設計パターンは避ける必要があります。
自動的に生成されるフィールドはフィールドの自動レンダリングを表すので、データ バインド コントロールでは通常、ユーザーがオブジェクトの AutoGeneratedField プロパティを変更することはできません。 自動レンダリングがニーズに適していない場合は、コントロールのフィールド コレクションに独自のデータ フィールドを定義します。
コンストラクター
AutoGeneratedField(String) |
データ フィールドを指定して、AutoGeneratedField クラスの新しいインスタンスを初期化します。 |
プロパティ
AccessibleHeaderText |
一部のコントロールの |
ApplyFormatInEditMode |
DataFormatString オブジェクトを格納しているデータ バインド コントロールが編集モードである場合に、BoundField プロパティで指定した書式指定文字列をフィールド値に適用するかどうかを示す値を取得または設定します。 (継承元 BoundField) |
Control |
DataControlField オブジェクトが関連付けられているデータ コントロールの参照を取得します。 (継承元 DataControlField) |
ControlStyle |
DataControlField オブジェクトに格納されているすべての Web サーバー コントロールのスタイルを取得します。 (継承元 DataControlField) |
ConvertEmptyStringToNull |
データ ソースからフィールドを取得するときに空の文字列 ("") 値が |
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) |
メソッド
明示的なインターフェイスの実装
IDataSourceViewSchemaAccessor.DataSourceViewSchema |
DataControlField オブジェクトに関連付けられているスキーマを取得または設定します。 (継承元 DataControlField) |
IStateManager.IsTrackingViewState |
DataControlField オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 (継承元 DataControlField) |
IStateManager.LoadViewState(Object) |
データ コントロール フィールドの、以前保存したビューステートを復元します。 (継承元 DataControlField) |
IStateManager.SaveViewState() |
ページがサーバーにポストバックされた時間以降に発生した、DataControlField ビューステートへの変更を保存します。 (継承元 DataControlField) |
IStateManager.TrackViewState() |
DataControlField オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState プロパティに格納して、同じページに対する複数の要求にわたって永続化できます。 (継承元 DataControlField) |
適用対象
こちらもご覧ください
.NET