AutoGeneratedFieldProperties クラス

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

AutoGeneratedFieldProperties クラス

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

AutoGeneratedField オブジェクトのプロパティを表します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 AutoGeneratedFieldProperties
    Implements IStateManager

Visual Basic (使用法)

Dim instance As AutoGeneratedFieldProperties

C#

public sealed class AutoGeneratedFieldProperties
 : IStateManager

C++

public ref class AutoGeneratedFieldProperties
 sealed : IStateManager

J#

public final class AutoGeneratedFieldProperties
 implements IStateManager

JScript

public final class AutoGeneratedFieldProperties
 implements IStateManager

解説

AutoGeneratedFieldProperties クラスは、データ バインド コントロールによって使用され、自動生成フィールドの作成時に AutoGeneratedField オブジェクトのプロパティを指定します。たとえば、DetailsView コントロールが自動生成行を作成する場合、その行のプロパティを基に AutoGeneratedFieldProperties オブジェクトを作成し、CreateAutoGeneratedRow メソッドに渡します。同様に、GridView コントロールは、自動生成列を作成する際、AutoGeneratedFieldProperties オブジェクトを CreateAutoGeneratedColumn メソッドに渡します。

メモ
このクラスは、通常、GridView コントロールまたは DetailsView コントロールを拡張する場合にのみ使用されます。

DataField プロパティを設定すると、AutoGeneratedField オブジェクトにバインドするフィールド名を指定できます。フィールド値のデータ型を指定するには、Type プロパティを設定します。IsReadOnly プロパティを true に設定すると、ユーザーがフィールド値を変更しないようにできます。Name プロパティを設定すると、AutoGeneratedField オブジェクトに名前を付けることもできます。

使用例

AutoGeneratedFieldProperties クラスを使用して、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;
        }
        
    }
}

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)。要求値 : LinkDemand。アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)。要求値 : InheritanceDemand。アクセス許可値 : Minimal。

継承階層

System.Object
  System.Web.UI.WebControls.AutoGeneratedFieldProperties

スレッド セーフ

この型の 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

参照

関連項目
AutoGeneratedFieldProperties メンバ
System.Web.UI.WebControls 名前空間
AutoGeneratedFieldProperties クラス
CreateAutoGeneratedRow
CreateAutoGeneratedColumn
DataField
IsReadOnly
Name
Type