DisplayFormatAttribute Classe

Définition

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
DisplayFormatAttribute
Attributs

Exemples

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

L’exemple suivant montre comment utiliser la DisplayFormatAttribute mise en forme pour 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, elle 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 au format monétaire spécifique aux paramètres régionaux.

    • Afficher les informations de date au format court (mm/jj/yy). 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 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 Exemples de produits : Base de données sur GitHub. Assurez-vous d’installer la version correcte de l’exemple de base de données pour la version de SQL Server que vous exécutez.

  • 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 recommandations en matière de 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)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.

(Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface.

(Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).

(Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.

(Hérité de Attribute)

S’applique à

Voir aussi