AutoGeneratedField Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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.

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

Héritage: Object

DataControlField

BoundField
AutoGeneratedField

Exemples

L’exemple suivant montre comment créer un AutoGeneratedField objet pour un contrôle personnalisé qui dérive du DetailsView contrôle .


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

Remarques

La AutoGeneratedField classe 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 est définie true sur (par exemple, la AutoGenerateColumns propriété pour le GridView contrôle, la AutoGenerateRows propriété pour le DetailsView contrôle, etc.).

Notes

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 Columns collection pour le GridView contrôle, la Fields collection pour le DetailsView contrôle, etc.).

La AutoGeneratedField classe est destinée à ê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 AutoGeneratedField classe ne peut pas être placée de manière déclarative sur une page dans le cadre d’une collection de champs. Bien que vous puissiez ajouter par programmation un AutoGeneratedField objet à une collection de champs, ce modèle de conception doit être évité.

Étant donné que les champs générés automatiquement représentent le rendu automatique d’un champ, les contrôles liés aux données n’autorisent généralement pas les utilisateurs à modifier les propriétés des AutoGeneratedField objets. Si le rendu automatique n’est pas adapté à vos besoins, définissez vos propres champs de données pour la collection de champs du contrôle.

Constructeurs

AutoGeneratedField(String)

Initialise une nouvelle instance de la classe AutoGeneratedField avec les champs de données spécifiés.

Propriétés

AccessibleHeaderText	Obtient ou définit le texte restitué sous forme de valeur de propriété `AbbreviatedText` dans certains contrôles. (Hérité de DataControlField)
ApplyFormatInEditMode	Obtient ou définit une valeur indiquant si la chaîne de mise en forme spécifiée par la propriété DataFormatString s'applique aux valeurs de champ lorsque le contrôle lié aux données qui contient l'objet BoundField est en mode édition. (Hérité de BoundField)
Control	Obtient une référence au contrôle de données auquel l'objet DataControlField est associé. (Hérité de DataControlField)
ControlStyle	Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField. (Hérité de DataControlField)
ConvertEmptyStringToNull	Obtient ou définit une valeur indiquant si les valeurs de chaîne vides ("") sont converties en `null` lorsque les valeurs de champ sont récupérées de la source de données.
DataField	Obtient ou définit le nom du champ de données lié à lier à l'objet BoundField. (Hérité de BoundField)
DataFormatString	Obtient ou définit la chaîne qui spécifie le format dans lequel le texte de remplacement pour chaque image dans un objet AutoGeneratedField est restitué.
DataType	Obtient ou définit le type de données des valeurs affichées dans un objet AutoGeneratedField.
DesignMode	Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design. (Hérité de DataControlField)
FooterStyle	Obtient ou définit le style du pied de page du champ de contrôle de données. (Hérité de DataControlField)
FooterText	Obtient ou définit le texte affiché dans l'élément de pied de page d'un champ de contrôle de données. (Hérité de DataControlField)
HeaderImageUrl	Obtient ou définit l'URL d'une image affichée dans l'élément d'en-tête d'un champ de contrôle de données. (Hérité de DataControlField)
HeaderStyle	Obtient ou définit le style de l'en-tête du champ de contrôle de données. (Hérité de DataControlField)
HeaderText	Obtient ou définit le texte qui s'affiche dans l'en-tête d'un contrôle de données. (Hérité de BoundField)
HtmlEncode	Obtient ou définit une valeur indiquant si les valeurs de champ sont encodées en HTML avant qu'elles soient affichées dans un objet BoundField. (Hérité de BoundField)
HtmlEncodeFormatString	Obtient ou définit une valeur qui indique si le texte créé en appliquant la propriété DataFormatString à la valeur BoundField doit être encodé en HTML lorsqu'il est affiché. (Hérité de BoundField)
InsertVisible	Obtient ou définit une valeur indiquant si l'objet AutoGeneratedField est visible en mode insertion.
IsTrackingViewState	Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField)
ItemStyle	Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données. (Hérité de DataControlField)
NullDisplayText	Obtient ou définit la légende affichée pour un champ lorsque la valeur du champ est null. (Hérité de BoundField)
ReadOnly	Obtient ou définit une valeur indiquant si la valeur du champ peut être modifiée en mode édition. (Hérité de BoundField)
ShowHeader	Obtient ou définit une valeur indiquant si l'élément d'en-tête d'un champ de contrôle de données est restitué. (Hérité de DataControlField)
SortExpression	Obtient ou définit une expression de tri utilisée par un contrôle de source de données pour trier des données. (Hérité de DataControlField)
SupportsHtmlEncode	Obtient une valeur indiquant si l'encodage en HTML est pris en charge par un objet BoundField. (Hérité de BoundField)
ValidateRequestMode	Obtient ou définit une valeur qui détermine si le contrôle valide l'entrée cliente ou non. (Hérité de BoundField)
ViewState	Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet DataControlField entre plusieurs demandes de la même page. (Hérité de DataControlField)
Visible	Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué. (Hérité de DataControlField)

Méthodes

CloneField()	Crée une copie de l'objet dérivé de DataControlField en cours. (Hérité de DataControlField)
CopyProperties(DataControlField)	Copie les propriétés de l'objet BoundField actuel vers l'objet DataControlField spécifié. (Hérité de BoundField)
CreateField()	Crée un objet BoundField vide. (Hérité de BoundField)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Remplit l'objet IOrderedDictionary spécifié avec les valeurs provenant de l'objet DataControlFieldCell spécifié.
FormatDataValue(Object, Boolean)	Met en forme la valeur de champ spécifiée pour une cellule dans l'objet BoundField. (Hérité de BoundField)
GetDesignTimeValue()	Récupère la valeur utilisée pour un champ lors du rendu de l'objet BoundField dans un concepteur. (Hérité de BoundField)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(Control)	Récupère la valeur du champ lié à l'objet BoundField. (Hérité de BoundField)
Initialize(Boolean, Control)	Initialise l'objet BoundField. (Hérité de BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initialise l'objet TableCell spécifié à l'état de ligne spécifié. (Hérité de BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Initialise l'objet TableCell spécifié à l'état de ligne spécifié. (Hérité de BoundField)
LoadViewState(Object)	Restaure les informations d'état d'affichage précédemment enregistrées pour ce champ. (Hérité de BoundField)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnDataBindField(Object, EventArgs)	Lie la valeur d'un champ à l'objet BoundField. (Hérité de BoundField)
OnFieldChanged()	Déclenche l’événement `FieldChanged`. (Hérité de DataControlField)
SaveViewState()	Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField)
ToString()	Retourne une chaîne qui représente cet objet DataControlField. (Hérité de DataControlField)
TrackViewState()	Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page. (Hérité de DataControlField)
ValidateSupportsCallback()	Détermine si les contrôles contenus dans un objet AutoGeneratedField prennent en charge les rappels.

Implémentations d’interfaces explicites

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtient ou définit le schéma associé à cet objet DataControlField. (Hérité de DataControlField)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField)
IStateManager.LoadViewState(Object)	Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données. (Hérité de DataControlField)
IStateManager.SaveViewState()	Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField)
IStateManager.TrackViewState()	Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page. (Hérité de DataControlField)

S’applique à