DisplayFormatAttribute Osztály

Definíció

Névtér:

System.ComponentModel.DataAnnotations

Szerelvény:

System.ComponentModel.Annotations.dll

Forrás:

DisplayFormatAttribute.cs

Megadja, hogyan jelennek meg és formázhatók az adatmezők a dinamikus adatok ASP.NET.

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

Öröklődés

Object

Attribute

DisplayFormatAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa bemutatja, hogyan szabhatja testre az DisplayFormatAttribute adatmezők formázását. A példa a következő lépéseket hajtja végre:

• Metaadat-részleges osztályt és társított metaadatosztályt implementál.

• A társított metaadatosztályban az DisplayFormatAttribute attribútumot alkalmazza a következő eredmények megadására:

  • A(z) "[Null]" szöveg megjelenítése, ha egy adatmező üres.
  • Pénznemadatok megjelenítése területi adott pénznemformátumban.
  • Dátumadatok megjelenítése rövid formátumban (mm/dd/ééé). Ez a formátum szerkesztési módban is érvényes.

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

A példa fordításához a következőkre van szüksége:

• A Visual Studio 2010-ben vagy újabb verzióiban.
• Az AdventureWorksLT mintaadatbázis. A SQL Server mintaadatbázis letöltéséről és telepítéséről a GitHub Microsoft SQL Server Termékminták: Adatbázis című témakörben olvashat. Győződjön meg arról, hogy a mintaadatbázis megfelelő verzióját telepíti a futó SQL Server verziójához.
• Adatvezérelt webhely. Így létrehozhat egy adatkörnyezetet az adatbázishoz és a testre szabni kívánt adatmezőt tartalmazó osztályhoz. További információért lásd Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Megjegyzések

Ha ezt az attribútumot egy adatmezőre alkalmazza, az attribútumok használatára vonatkozó irányelveket kell követnie. További információ: ASP.NET Dinamikus adatokra vonatkozó irányelvek.

Konstruktorok

Name	Description
DisplayFormatAttribute()	Inicializálja a DisplayFormatAttribute osztály új példányát.

Tulajdonságok

Name	Description
ApplyFormatInEditMode	Lekéri vagy beállít egy értéket, amely jelzi, hogy a tulajdonság által DataFormatString megadott formázási sztring a mező értékére lesz-e alkalmazva, amikor az adatmező szerkesztési módban van.
ConvertEmptyStringToNull	Lekéri vagy beállít egy értéket, amely jelzi, hogy az üres sztringértékek ("") automatikusan át lesznek-e alakítva null az adatforrás adatmezőjének frissítésekor.
DataFormatString	Lekéri vagy beállítja a mezőérték megjelenítési formátumát.
HtmlEncode	Lekéri vagy beállít egy értéket, amely jelzi, hogy a mező HTML-kódolású-e.
NullDisplayText	Lekéri vagy beállítja a mezőhöz megjelenített szöveget, ha a mező értéke .null
NullDisplayTextResourceType	Lekéri vagy beállítja az Type erőforrásokat a következőhöz NullDisplayText: . Ezzel NullDisplayTextResourceType együtt NullDisplayTextlehetővé teszi, hogy a GetNullDisplayText() metódus honosított értékeket ad vissza.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetNullDisplayText()	A felhasználói felület megjelenítési sztringjét adja vissza a következőhöz NullDisplayText: .
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• Hogyan állítsa be a kulturális és felhasználói felületi kultúrát ASP.NET weblap globalizációjához