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

Podívejte se na online příklad této funkce: Spustit.

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.

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

  • Pokud je datové pole prázdné, zobrazí se text [Null].

  • Zobrazí data měny ve formátu měny specifickém pro národní prostředí.

  • Zobrazí informace 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 sady 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 Ukázky produktů Microsoft SQL Server: Databáze na GitHubu. 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 vám umožní vytvořit kontext dat pro databázi a třídu, která obsahuje datové pole, které chcete přizpůsobit. Další informace naleznete v tématu Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Poznámky

Při použití tohoto atributu u datového pole musíte postupovat podle pokynů pro použití atributů. Další informace najdete v tématu ASP.NET pokyny k dynamickým datům.

Konstruktory

DisplayFormatAttribute()

Inicializuje novou instanci DisplayFormatAttribute třídy.

Vlastnosti

ApplyFormatInEditMode	Získá nebo nastaví hodnotu, která označ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 pole má být kódování HTML.
NullDisplayText	Získá nebo nastaví text zobrazený pro pole, pokud je nullhodnota pole .
NullDisplayTextResourceType	Získá nebo nastaví , Type který obsahuje prostředky pro NullDisplayText. Použití NullDisplayTextResourceType společně s NullDisplayTextnástrojem umožňuje GetNullDisplayText() metodě vracet lokalizované hodnoty.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetNullDisplayText()	Vrátí řetězec zobrazení uživatelského rozhraní pro NullDisplayText.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance 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á označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Postupy: Nastavení jazykové verze a jazykové verze uživatelského rozhraní pro ASP.NET globalizaci webových stránek