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

継承

Object

DataControlField

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

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

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

こちらもご覧ください

• DetailsView
• GridView
• AutoGeneratedFieldProperties
• BoundField
• ButtonField
• CheckBoxField
• CommandField
• HyperLinkField
• ImageField
• TemplateField
• Columns
• Fields
• CreateAutoGeneratedColumn(AutoGeneratedFieldProperties)
• CreateAutoGeneratedRow(AutoGeneratedFieldProperties)