DisplayFormatAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel.DataAnnotations

Zestaw:

System.ComponentModel.Annotations.dll

Źródło:

DisplayFormatAttribute.cs

Określa sposób wyświetlania i formatowania pól danych przez ASP.NET danych dynamicznych.

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

Dziedziczenie

Object

Attribute

DisplayFormatAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

Zapoznaj się z przykładem tej funkcji online: Uruchom.

W poniższym przykładzie pokazano, jak dostosować formatowanie pola danych za pomocą DisplayFormatAttribute elementu . W przykładzie są wykonywane następujące kroki:

• Implementuje klasę częściową metadanych i skojarzą klasę metadanych.

• W skojarzonej klasie metadanych stosuje DisplayFormatAttribute atrybut w celu określenia następujących wyników:

  • Wyświetl tekst "[Null]", gdy pole danych jest puste.

  • Wyświetl dane waluty w formacie waluty specyficznej dla ustawień regionalnych.

  • Wyświetl informacje o dacie w formacie krótkim (mm/dd/rr). Ten format ma również zastosowanie w trybie edycji.

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

Aby skompilować przykład, potrzebne są następujące elementy:

• Dowolna wersja programu Visual Studio 2010 lub nowszego.

• Przykładowa baza danych AdventureWorksLT. Aby uzyskać informacje na temat pobierania i instalowania przykładowej bazy danych SQL Server, zobacz Przykłady produktów Microsoft SQL Server: Database on GitHub. Upewnij się, że zainstalowano poprawną wersję przykładowej bazy danych dla wersji SQL Server, która jest uruchomiona.

• Witryna internetowa oparta na danych. Dzięki temu można utworzyć kontekst danych dla bazy danych i klasy zawierającej pole danych do dostosowania. Aby uzyskać więcej informacji, zobacz Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Uwagi

Po zastosowaniu tego atrybutu do pola danych należy postępować zgodnie z wytycznymi dotyczącymi używania atrybutów. Aby uzyskać więcej informacji, zobacz wskazówki dotyczące danych dynamicznych ASP.NET.

Konstruktory

DisplayFormatAttribute()

Inicjuje nowe wystąpienie klasy DisplayFormatAttribute.

Właściwości

ApplyFormatInEditMode	Pobiera lub ustawia wartość wskazującą, czy ciąg formatowania określony przez DataFormatString właściwość jest stosowany do wartości pola, gdy pole danych jest w trybie edycji.
ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, czy wartości pustych ciągów ("") są automatycznie konwertowane na null czas aktualizowania pola danych w źródle danych.
DataFormatString	Pobiera lub ustawia format wyświetlania wartości pola.
HtmlEncode	Pobiera lub ustawia wartość wskazującą, czy pole powinno być zakodowane w formacie HTML.
NullDisplayText	Pobiera lub ustawia tekst wyświetlany dla pola, gdy wartość pola to null.
NullDisplayTextResourceType	Pobiera lub ustawia element Type zawierający zasoby dla parametru NullDisplayText. Użycie NullDisplayTextResourceType elementu wraz z elementem NullDisplayTextumożliwia metodzie GetNullDisplayText() zwracanie zlokalizowanych wartości.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetNullDisplayText()	Zwraca ciąg wyświetlania interfejsu użytkownika dla elementu NullDisplayText.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Instrukcje: ustawianie kultury i kultury interfejsu użytkownika na potrzeby globalizacji stron internetowych ASP.NET