Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DisplayFormatAttribute

 

Publicado: octubre de 2016

Especifica cómo se muestran y se da formato a los datos dinámicos de ASP.NET los campos de datos.

Espacio de nombres:   System.ComponentModel.DataAnnotations
Ensamblado:  System.ComponentModel.DataAnnotations (en System.ComponentModel.DataAnnotations.dll)

System.Object
  System.Attribute
    System.ComponentModel.DataAnnotations.DisplayFormatAttribute

[AttributeUsageAttribute(AttributeTargets.Property | AttributeTargets.Field, 
	AllowMultiple = false)]
public class DisplayFormatAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodDisplayFormatAttribute()

Inicializa una nueva instancia de la clase DisplayFormatAttribute.

NombreDescripción
System_CAPS_pubpropertyApplyFormatInEditMode

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

System_CAPS_pubpropertyConvertEmptyStringToNull

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

System_CAPS_pubpropertyDataFormatString

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

System_CAPS_pubpropertyHtmlEncode

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

System_CAPS_pubpropertyNullDisplayText

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

System_CAPS_pubpropertyTypeId

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

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia es igual que un objeto especificado.(Heredado de Attribute).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

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).

System_CAPS_pubmethodMatch(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).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_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).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

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

System_CAPS_pubinterfaceSystem_CAPS_privmethod_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).

Al aplicar este atributo a un campo de datos, debe seguir las directrices para el uso de los atributos. Para obtener más información, consulte directrices de datos dinámicos de ASP.NET.

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

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

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

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

    • Mostrar 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/aa). 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;
}

Para compilar el ejemplo, necesitará lo siguiente:

  • Microsoft Visual Studio 2008 Service Pack 1 o Visual Web Developer 2008 Express Service Pack 1.

  • La base de datos de ejemplo AdventureWorksLT. Para obtener información acerca de cómo descargar e instalar la base de datos de ejemplo de SQL Server, vea Microsoft SQL Server Product Samples: Database en el sitio CodePlex. 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 (Microsoft SQL Server 2005 o Microsoft SQL Server 2008).

  • 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 para personalizar. Para obtener más información, consulta Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 3.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 3.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: