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 seguinte mostra como usar o DisplayFormatAttribute para personalizar a formatação de um campo de dados. O exemplo executa os seguintes passos:

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

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

  • Mostrar o texto "[Null]" quando um campo de dados estiver vazio.
  • Mostrar dados de moeda num formato monetário específico da localidade.
  • Mostrar a informação da data em formato curto (mm/dd/aa). Este 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, precisa do seguinte:

• Qualquer edição do Visual Studio 2010 ou posterior.
• A base de dados de exemplos AdventureWorksLT. Para informações sobre como descarregar e instalar a base de dados de exemplos SQL Server, consulte Microsoft SQL Server Product Samples: Database no GitHub. Certifica-te de que instalas a versão correta da base de dados de exemplo para a versão do SQL Server que estás a usar.
• Um site orientado por dados. Isto permite-lhe criar um contexto de dados para a base de dados e a classe que contém o campo de dados para personalizar. Para obter mais informações, veja Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Observações

Quando aplica este atributo a um campo de dados, deve seguir as orientações para a utilização dos atributos. Para mais informações, consulte ASP.NET Diretrizes de Dados Dinâmicos.

Ver também

• Como: Definir a Cultura e a Cultura da UI para ASP.NET Globalização da Página Web