DisplayFormatAttribute Clase

Definición

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

Herencia

Object

Attribute

DisplayFormatAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo usar para personalizar el DisplayFormatAttribute formato de un campo de datos. En el ejemplo se realizan los pasos siguientes:

• Implementa una clase parcial de metadatos y una clase de metadatos asociada.

• En la clase de metadatos asociada, aplica el DisplayFormatAttribute atributo para especificar los siguientes resultados:

  • Muestra el texto "[Null]" cuando un campo de datos está vacío.
  • Mostrar datos de moneda en formato de moneda específico de configuración regional.
  • Mostrar información de fecha en formato corto (mm/dd/aaaa). Este formato también se aplica en modo de edición.

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 el ejemplo, necesita lo siguiente:

• Cualquier edición de Visual Studio 2010 o posterior.
• Base de datos de ejemplo AdventureWorksLT. Para obtener información sobre cómo descargar e instalar la base de datos de ejemplo de SQL Server, vea Microsoft SQL Server Product Samples: Database on GitHub. Asegúrese de instalar la versión correcta de la base de datos de ejemplo para la versión de SQL Server que está ejecutando.
• Un sitio web controlado por datos. Esto le permite crear un contexto de datos para la base de datos y la clase que contiene el campo de datos que se va a personalizar. Para obtener más información, consulte Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Comentarios

Al aplicar este atributo a un campo de datos, debe seguir las instrucciones para el uso de los atributos.