AutoGeneratedField, classe

La classe AutoGeneratedField est utilisée pour représenter un champ généré automatiquement dans un contrôle lié aux données, tel que GridView ou DetailsView. Les champs générés automatiquement sont créés par un contrôle lié aux données lorsque la propriété appropriée a la valeur true (par exemple, la propriété AutoGenerateColumns pour le contrôle GridView, la propriété AutoGenerateRows pour le contrôle DetailsView, et ainsi de suite).

Remarque
Les champs générés automatiquement ne sont pas ajoutés à la collection de champs d'un contrôle lié aux données (par exemple, la collection Columns pour le contrôle GridView, la collection Fields pour le contrôle DetailsView, et ainsi de suite).

La classe AutoGeneratedField est prévue pour être utilisée en interne par les contrôles liés aux données. Contrairement à d'autres champs de données (tels que BoundField, CheckBoxField, TemplateField, etc.), la classe AutoGeneratedField ne peut pas être placée de manière déclarative sur une page en tant que collection de champs. Même s'il est possible d'ajouter par programme un objet AutoGeneratedField à une collection de champs, ce modèle de design doit être évité.

Comme les champs générés automatiquement représentent le rendu automatique d'un champ, les contrôles liés aux données ne permettent généralement pas aux utilisateurs de modifier les propriétés des objets AutoGeneratedField. Si le rendu automatique ne correspond pas à vos besoins, définissez vos propres champs de données pour la collection de champs du contrôle.

L'exemple suivant montre comment créer un objet AutoGeneratedField pour un contrôle personnalisé dérivé du contrôle 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;
        }

    }
}

.NET Framework

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence