DisplayFormatAttribute Třída

Definice

Obor názvů:

System.ComponentModel.DataAnnotations

Sestavení:

System.ComponentModel.Annotations.dll

Zdroj:

DisplayFormatAttribute.cs

Určuje způsob zobrazení a formátování datových polí pomocí ASP.NET dynamických dat.

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

Dědičnost

Object

Attribute

DisplayFormatAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad ukazuje, jak použít DisplayFormatAttribute k přizpůsobení formátování datového pole. Příklad provede následující kroky:

• Implementuje částečnou třídu metadat a přidruženou třídu metadat.

• Ve třídě přidružených metadat použije DisplayFormatAttribute atribut k určení následujících výsledků:

  • Zobrazí text [Null], pokud je datové pole prázdné.
  • Umožňuje zobrazit data měny v konkrétním formátu měny v národním prostředí.
  • Zobrazení informací o datu v krátkém formátu (mm/dd/rr). Tento formát platí také v režimu úprav.

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

K kompilaci příkladu potřebujete následující:

• Libovolná edice Visual Studio 2010 nebo novější.
• Ukázková databáze AdventureWorksLT. Informace o tom, jak stáhnout a nainstalovat ukázkovou databázi SQL Server, najdete v tématu Microsoft SQL Server Ukázky produktů: Databáze na GitHub. Ujistěte se, že jste nainstalovali správnou verzi ukázkové databáze pro verzi SQL Server, kterou používáte.
• Web řízený daty To umožňuje vytvořit kontext dat pro databázi a třídu, která obsahuje datové pole pro přizpůsobení. Další informace najdete na webu Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Poznámky

Pokud tento atribut použijete u datového pole, musíte postupovat podle pokynů pro použití atributů.

Konstruktory

Name	Description
DisplayFormatAttribute()	Inicializuje novou instanci DisplayFormatAttribute třídy.

Vlastnosti

Name	Description
ApplyFormatInEditMode	Získá nebo nastaví hodnotu, která určuje, zda formátovací řetězec, který je určen DataFormatString vlastností je použit na hodnotu pole, když datové pole je v režimu úprav.
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu, která označuje, zda prázdné řetězcové hodnoty ("") jsou automaticky převedeny na null při aktualizaci datového pole ve zdroji dat.
DataFormatString	Získá nebo nastaví formát zobrazení pro hodnotu pole.
HtmlEncode	Získá nebo nastaví hodnotu, která označuje, zda má být pole kódováno HTML.
NullDisplayText	Získá nebo nastaví text, který se zobrazí pro pole, když je nullhodnota pole .
NullDisplayTextResourceType	Získá nebo nastaví Type , který obsahuje prostředky pro NullDisplayText. Použití NullDisplayTextResourceType spolu s NullDisplayText, umožňuje metodu GetNullDisplayText() vrátit lokalizované hodnoty.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetNullDisplayText()	Vrátí zobrazovaný řetězec uživatelského rozhraní pro NullDisplayText.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)