DisplayFormatAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

DisplayFormatAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene illustrato come usare per personalizzare la DisplayFormatAttribute formattazione per un campo dati. L'esempio esegue i passaggi seguenti:

• Implementa una classe parziale di metadati e una classe di metadati associata.

• Nella classe di metadati associata applica l'attributo DisplayFormatAttribute per specificare i risultati seguenti:

  • Visualizzare il testo "[Null]" quando un campo dati è vuoto.
  • Visualizzare i dati di valuta in formato valuta specifico delle impostazioni locali.
  • Visualizzare le informazioni sulla data in formato breve (mm/gg/yy). Questo formato si applica anche in modalità di modifica.

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

Per compilare l'esempio, è necessario quanto segue:

• Qualsiasi edizione di Visual Studio 2010 o versione successiva.
• Database di esempio AdventureWorksLT. Per informazioni su come scaricare e installare il database di esempio SQL Server, vedere Microsoft SQL Server Product Samples: Database in GitHub. Assicurarsi di installare la versione corretta del database di esempio per la versione di SQL Server in esecuzione.
• Sito Web basato sui dati. In questo modo è possibile creare un contesto dati per il database e la classe che contiene il campo dati da personalizzare. Per altre informazioni, vedere Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Commenti

Quando si applica questo attributo a un campo dati, è necessario seguire le linee guida per l'uso degli attributi.