Modèles de champs par défaut Dynamic Data ASP.NET
Mise à jour : novembre 2007
Les modèles de champs sont des contrôles utilisateur ASP.NET qui mappent le champ de contrôle de données aux types de données dans un modèle de données. Ces contrôles sont dérivés de la classe FieldTemplateUserControl qui permet d'accéder aux champs de données, aux colonnes de base de données et aux métadonnées. Dynamic Data utilise des modèles de champs pour afficher automatiquement des données en fonction du schéma de base de données et du type de données, et permettre aux utilisateurs de modifier et d'insérer des données dans un modèle à l'aide de très peu, voire d'aucun code. Dynamic data fournit des modèles de champs par défaut lorsque vous créez une application Web Dynamic Data.
Modèles de champs par défaut
Dynamic Data ASP.NET détermine le type des données du modèle et utilise le modèle de champ personnalisé ou par défaut approprié pour restituer les données dans un contrôle. Le modèle de champ restitué dépend à la fois du type de données, UIHint ou DataTypeAttribute défini, et du mode du contrôle de données (affichage, édition ou insertion). Lorsque vous créez un projet Dynamic Data dans Visual Studio 2008, les modèles de champs par défaut sont créés dans le répertoire DynamicData\FieldTemplates.
Le tableau suivant décrit les modèles de champs par défaut dans les projets Dynamic Data ASP.NET.
Modèle de champ par défaut |
Description |
|---|---|
Boolean.ascx |
Affiche le type de données Boolean . Génère le rendu d'un contrôle CheckBox. Le contrôle CheckBox est désactivé et ne peut pas être modifié. |
Boolean_Edit.ascx |
Permet aux utilisateurs de modifier des valeurs Boolean. Génère le rendu d'un contrôle CheckBox. |
Children.ascx |
Affiche les champs qui ont une relation un-à-plusieurs et redirige l'utilisateur vers la page de relation. Génère le rendu d'un contrôle HyperLink. |
DateTime.ascx |
Affiche le type de données DateTime sous forme de texte. Restitué sous forme d'un littéral. |
DateTime_Edit.ascx |
Génère le rendu d'un contrôle TextBox. Si le champ dans la base de données ne peut pas être null ou si un attribut requis est ajouté au modèle de données, ce contrôle génère également le rendu d'un contrôle RequiredFieldValidator. Le modèle de champ DateTime_Edit.ascx fournit un contrôle System.Web.DynamicData.DynamicValidator qui gère les exceptions levées à partir du modèle de données. Il prend en charge la classe Regex. |
Decimal_Edit.ascx |
Génère le rendu d'un contrôle TextBox. Génère également le rendu d'un contrôle CompareValidator qui vérifie que l'entrée peut être convertie en un type de données Decimal. Si le champ dans la base de données ne peut pas être null ou si un attribut requis est ajouté au modèle de données, ce contrôle génère également le rendu d'un contrôle RequiredFieldValidator. Si le champ a un attribut de plage, il génère également le rendu d'un contrôle RangeValidator. Le modèle de champ Decimal_Edit.ascx fournit un contrôle System.Web.DynamicData.DynamicValidator qui gère les exceptions levées à partir du modèle de données. Ce modèle de champ prend en charge la classe Regex. |
ForeignKey.ascx |
Affiche les champs qui ont une relation plusieurs-à-un. Génère le rendu d'un contrôle HyperLink qui redirige l'utilisateur vers la page de relation. |
ForeignKey_Edit.ascx |
Permet de modifier les champs qui ont une relation plusieurs-à-un. Génère le rendu d'un contrôle DropDownList qui permet aux utilisateurs de sélectionner des clés étrangères dans le modèle de données. |
Integer_Edit.ascx |
Génère le rendu d'un contrôle TextBox et d'un CompareValidator qui vérifie que l'entrée contenue dans la zone de texte peut être convertie en un entier. Si le champ dans la base de données ne peut pas être null ou si un attribut requis est ajouté au modèle de données, ce contrôlegénère également le rendu d'un contrôle RequiredFieldValidator. Si le champ dans le modèle a un attribut de plage, il génère également le rendu d'un contrôle RangeValidator. Integer_Edit.ascx fournit un contrôle System.Web.DynamicData.DynamicValidator qui gère les exceptions levées à partir du modèle de données. Il prend en charge la classe Regex. |
Text.ascx |
Affiche String, Decimal, Double et Int32 incluant d'autres types d'entiers tels que byte, short et long. Restitué sous forme d'un littéral. |
Text_Edit.ascx |
Génère le rendu d'un contrôle TextBox. La propriété TextMode de la zone de texte a la valeur SingleLine. Si le champ dans la base de données ne peut pas être null ou si un attribut requis est ajouté au modèle de données, Text_Edit.ascxgénère également le rendu d'un contrôle RequiredFieldValidator. Si le champ dans la base de données a une longueur associée, la propriété MaxLength du contrôle de zone de texte est appliquée. S'il existe un attribut RegularExpression sur le modèle de données, le modèle de champ par défaut génère également le rendu d'un contrôle RegularExpressionValidator. Text_Edit.ascx fournit un contrôle System.Web.DynamicData.DynamicValidator qui gère les exceptions levées à partir du modèle de données. |
Multiline_Edit.ascx |
Utilisé pour les champs de base de données marqués comme blocs de texte. Par exemple, dans SQL Server, Multiline_Edit.ascx mappe aux types de données TEXT, NTEXT, VARCHAR(MAX), NVARCHAR(MAX) . Génère le rendu d'un contrôle TextBox. La propriété TextMode de la zone de texte a la valeur MultiLine. Si le champ dans la base de données ne peut pas être null ou si un attribut requis est ajouté au modèle de données, TextArea_Edit.ascx génère également le rendu d'un contrôle RequiredFieldValidator. Si un attribut RegularExpression est ajouté au modèle de données, le champ de données génère également le rendu d'un contrôle RegularExpressionValidator. TextArea_Edit.ascx fournitun contrôle System.Web.DynamicData.DynamicValidator qui gère les exceptions levées à partir du modèle de données. |
Personnalisation des modèles par défaut
Vous pouvez personnaliser les modèles de champs par défaut afin de modifier leur traitement d'affichage, d'édition et d'insertion. La modification affecte l'ensemble du site Web. Par exemple, vous pouvez modifier les couleurs d'arrière et de premier plan du modèle de champ DateTime_Edit.ascx en modifiant les propriétés BackColor et ForeColor de la zone de texte qui restitue le modèle de champ. Pour ce faire, définissez les propriétés BackColor et ForeColor dans un fichier .css. Pour plus d'informations, consultez Comment : personnaliser les modèles de champs par défaut Dynamic Data ASP.NET.
Voir aussi
Tâches
Comment : personnaliser l'affichage d'un champ de données dans le modèle de données