AutoGeneratedField クラス

.NET Framework クラス ライブラリ リファレンス

AutoGeneratedField クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 AutoGeneratedField
    Inherits BoundField

Visual Basic (使用法)

Dim instance As AutoGeneratedField

C#

public sealed class AutoGeneratedField : BoundField

C++

public ref class AutoGeneratedField sealed
 : public BoundField

J#

public final class AutoGeneratedField extends
 BoundField

JScript

public final class AutoGeneratedField extends
 BoundField

解説

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

メモ
自動生成フィールドは、データ バインド コントロールのフィールド コレクション (GridView コントロールの場合は Columns コレクション、DetailsView コントロールの場合は Fields コレクションなど) には追加されません。

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

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

使用例

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

Visual Basic

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

C#

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;
        }
        
    }
}

継承階層

System.Object
   System.Web.UI.WebControls.DataControlField
     System.Web.UI.WebControls.BoundField
      System.Web.UI.WebControls.AutoGeneratedField

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
AutoGeneratedField メンバ
System.Web.UI.WebControls 名前空間
DetailsView
GridView
AutoGeneratedFieldProperties
BoundField
ButtonField
CheckBoxField
CommandField
HyperLinkField
ImageField
TemplateField
GridView.Columns
Fields
CreateAutoGeneratedColumn
CreateAutoGeneratedRow