DisplayFormatAttribute Clase

Definición

Especifica el modo en que los datos dinámicos de ASP.NET muestran y dan formato a los campos de datos.

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

Ejemplos

Vea un ejemplo en línea de esta característica: Ejecutar.

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 resultados siguientes:

    • Muestra el texto "[Null]" cuando un campo de datos está vacío.

    • Mostrar datos de moneda en formato de moneda específico de la 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.

  • La 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, consulte Ejemplos de productos de Microsoft SQL Server: Base de datos en 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, vea 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. Para obtener más información, consulte ASP.NET Directrices de datos dinámicos.

Constructores

DisplayFormatAttribute()

Inicializa una nueva instancia de la clase DisplayFormatAttribute.

Propiedades

ApplyFormatInEditMode

Obtiene o establece un valor que indica si la cadena de formato especificada por la propiedad DataFormatString se aplica al valor de campo cuando el campo de datos se encuentra en modo de edición.

ConvertEmptyStringToNull

Obtiene o establece un valor que indica si los valores de cadena vacía ("") se convierten automáticamente en valores null al actualizar el campo de datos en el origen de datos.

DataFormatString

Obtiene o establece el formato de presentación del valor de campo.

HtmlEncode

Obtiene o establece un valor que indica si el campo debe estar codificado en HTML.

NullDisplayText

Obtiene o establece el texto que se muestra en un campo cuando el valor del campo es null.

NullDisplayTextResourceType

Obtiene o establece el objeto Type que contiene los recursos para NullDisplayText.

El uso de NullDisplayTextResourceType junto con NullDisplayText permite que el método GetNullDisplayText() devuelva valores localizados.

TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.

(Heredado de Attribute)

Métodos

Equals(Object)

Devuelve un valor que indica si esta instancia es igual que un objeto especificado.

(Heredado de Attribute)
GetHashCode()

Devuelve el código hash de esta instancia.

(Heredado de Attribute)
GetNullDisplayText()

Devuelve la cadena de representación de la interfaz de usuario para NullDisplayText.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.

(Heredado de Attribute)
Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.

(Heredado de Attribute)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Implementaciones de interfaz explícitas

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

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.

(Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.

(Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).

(Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.

(Heredado de Attribute)

Se aplica a

Consulte también