Exporter (0) Imprimer
Développer tout

AutoGeneratedField, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente un champ généré automatiquement dans un contrôle lié aux données. Cette classe ne peut pas être héritée.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public sealed class AutoGeneratedField : BoundField
public final class AutoGeneratedField extends BoundField
public final class AutoGeneratedField extends BoundField

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).

RemarqueRemarque

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


Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft