DisplayFormatAttribute Classe

Definição

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

Herança

Object

Attribute

DisplayFormatAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra como usar a DisplayFormatAttribute formatação para personalizar um campo de dados. O exemplo executa as seguintes etapas:

• Implementa uma classe parcial de metadados e uma classe de metadados associada.

• Na classe de metadados associada, ela aplica o DisplayFormatAttribute atributo para especificar os seguintes resultados:

  • Exiba o texto "[Null]" quando um campo de dados estiver vazio.
  • Exibir dados de moeda no formato de moeda específico da localidade.
  • Exibir informações de data em formato curto (mm/dd/yy). Esse formato também se aplica no modo de edição.

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

Para compilar o exemplo, você precisa do seguinte:

• Qualquer edição do Visual Studio 2010 ou posterior.
• O banco de dados de exemplo AdventureWorksLT. Para obter informações sobre como baixar e instalar o banco de dados de exemplo SQL Server, consulte Microsoft SQL Server Product Samples: Database on GitHub. Instale a versão correta do banco de dados de exemplo para a versão do SQL Server em execução.
• Um site controlado por dados. Isso permite que você crie um contexto de dados para o banco de dados e a classe que contém o campo de dados a ser personalizado. Para obter mais informações, consulte Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Comentários

Ao aplicar esse atributo a um campo de dados, você deve seguir as diretrizes para o uso dos atributos.