DisplayFormatAttribute Třída

Definice

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

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)

Explicitní implementace rozhraní

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

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu objektu, které lze použít k získání informací o typu pro rozhraní.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.

(Zděděno od Attribute)

Platí pro

Viz také