DisplayFormatAttribute Classe

Définition

Espace de noms:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

DisplayFormatAttribute.cs

Spécifie la manière dont les champs de données sont affichés et mis en forme par Dynamic Data ASP.NET.

public ref class DisplayFormatAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class DisplayFormatAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type DisplayFormatAttribute = class
    inherit Attribute

Public Class DisplayFormatAttribute
Inherits Attribute

Héritage

Object

Attribute

DisplayFormatAttribute

Attributs

AttributeUsageAttribute

Exemples

Consultez un exemple en ligne de cette fonctionnalité : Exécuter.

L’exemple suivant montre comment utiliser pour personnaliser la DisplayFormatAttribute mise en forme d’un champ de données. L’exemple effectue les étapes suivantes :

• Implémente une classe partielle de métadonnées et une classe de métadonnées associée.

• Dans la classe de métadonnées associée, il applique l’attribut DisplayFormatAttribute pour spécifier les résultats suivants :

  • Affichez le texte « [Null] » lorsqu’un champ de données est vide.

  • Affichez les données monétaires dans un format de devise spécifique aux paramètres régionaux.

  • Afficher les informations de date au format court (mm/jj/aaaa). Ce format s’applique également en mode édition.

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;

[MetadataType(typeof(ProductMetaData))]
public partial class Product
{
}

public class ProductMetaData
{
    
    // Applying DisplayFormatAttribute
    // Display the text [Null] when the data field is empty.
    // Also, convert empty string to null for storing.
    [DisplayFormat(ConvertEmptyStringToNull = true, NullDisplayText = "[Null]")]
    public object Size;

    // Display currency data field in the format $1,345.50.
    [DisplayFormat(DataFormatString="{0:C}")]
    public object StandardCost;

    // Display date data field in the short format 11/12/08.
    // Also, apply format in edit mode.
    [DisplayFormat(ApplyFormatInEditMode=true, DataFormatString = "{0:d}")]
    public object SellStartDate;
}

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations


<MetadataType(GetType(ProductMetaData))> _
Partial Public Class Product

End Class

Public Class ProductMetaData
   
    ' Applying DisplayFormatAttribute

    ' Display the text [Null] when the data field is empty.
    ' Also, convert empty string to null for storing.
    <DisplayFormat(ConvertEmptyStringToNull:=True, NullDisplayText:="[Null]")> _
    Public Size As Object

    ' Display currency data field in the format such as $1,345.50.
    <DisplayFormat(DataFormatString:="{0:C}")> _
    Public StandardCost As Object

    ' Display date data field in the short format such as 11/12/08.
    ' Also, apply format in edit mode.
    <DisplayFormat(ApplyFormatInEditMode:=True, DataFormatString:="{0:d}")> _
    Public SellStartDate As Object

End Class

Pour compiler l’exemple, vous avez besoin des éléments suivants :

• Toute édition de Visual Studio 2010 ou version ultérieure.

• Exemple de base de données AdventureWorksLT. Pour plus d’informations sur le téléchargement et l’installation de l’exemple de base de données SQL Server, consultez Microsoft SQL Server Product Samples : Database on GitHub. Veillez à installer la version correcte de l’exemple de base de données pour la version de SQL Server que vous exécutez.

• Un site Web piloté par les données. Cela vous permet de créer un contexte de données pour la base de données et la classe qui contient le champ de données à personnaliser. Pour plus d'informations, consultez Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Remarques

Lorsque vous appliquez cet attribut à un champ de données, vous devez suivre les instructions relatives à l’utilisation des attributs. Pour plus d’informations, consultez ASP.NET Instructions relatives aux données dynamiques.

Constructeurs

DisplayFormatAttribute()

Initialise une nouvelle instance de la classe DisplayFormatAttribute.

Propriétés

ApplyFormatInEditMode	Obtient ou définit une valeur qui indique si la chaîne de mise en forme spécifiée par la propriété DataFormatString est appliquée à la valeur de champ lorsque le champ de données est en mode Édition.
ConvertEmptyStringToNull	Obtient ou définit une valeur qui indique si les chaînes vides ("") sont converties automatiquement en valeurs null lorsque le champ de données est mis à jour dans la source de données.
DataFormatString	Obtient ou définit le format d'affichage de la valeur de champ.
HtmlEncode	Obtient ou définit une valeur qui indique si le champ doit être encodé en HTML.
NullDisplayText	Obtient ou définit le texte affiché pour un champ lorsque la valeur du champ est null.
NullDisplayTextResourceType	Obtient ou définit le Type qui contient les ressources pour NullDisplayText. L’utilisation de NullDisplayTextResourceType avec NullDisplayText, permet à la méthode GetNullDisplayText() de retourner des valeurs localisées.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetNullDisplayText()	Retourne la chaîne d’affichage de l’interface utilisateur pour NullDisplayText.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Comment : définir la culture et la culture d’interface utilisateur pour la globalisation des pages web ASP.NET