DisplayFormatAttribute Kelas

Definisi

Ruang nama:

System.ComponentModel.DataAnnotations

Rakitan:

System.ComponentModel.Annotations.dll

Sumber:

DisplayFormatAttribute.cs

Menentukan bagaimana bidang data ditampilkan dan diformat oleh ASP.NET Data Dinamis.

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

Warisan

Object

Attribute

DisplayFormatAttribute

Atribut

AttributeUsageAttribute

Contoh

Lihat contoh online fitur ini: Jalankan.

Contoh berikut ini memperlihatkan cara menggunakan DisplayFormatAttribute untuk mengkustomisasi pemformatan untuk bidang data. Contohnya melakukan langkah-langkah berikut:

• Menerapkan kelas parsial metadata dan kelas metadata terkait.

• Di kelas metadata terkait, ia menerapkan DisplayFormatAttribute atribut untuk menentukan hasil berikut:

  • Tampilkan teks "[Null]" saat bidang data kosong.

  • Tampilkan data mata uang dalam format mata uang tertentu lokal.

  • Tampilkan informasi tanggal dalam format pendek (mm/dd/yy). Format ini juga berlaku dalam mode edit.

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

Untuk mengkompilasi contoh, Anda memerlukan hal berikut:

• Setiap edisi Visual Studio 2010 atau yang lebih baru.

• Database sampel AdventureWorksLT. Untuk informasi tentang cara mengunduh dan menginstal database sampel SQL Server, lihat Sampel Produk Microsoft SQL Server: Database di GitHub. Pastikan Anda menginstal versi database sampel yang benar untuk versi SQL Server yang Anda jalankan.

• Situs Web berbasis data. Ini memungkinkan Anda membuat konteks data untuk database dan kelas yang berisi bidang data untuk dikustomisasi. Untuk informasi selengkapnya, lihat Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Keterangan

Saat Anda menerapkan atribut ini ke bidang data, Anda harus mengikuti panduan untuk penggunaan atribut. Untuk informasi selengkapnya, lihat ASP.NET Panduan Data Dinamis.

Konstruktor

DisplayFormatAttribute()

Menginisialisasi instans baru kelas DisplayFormatAttribute.

Properti

ApplyFormatInEditMode	Mendapatkan atau mengatur nilai yang menunjukkan apakah string pemformatan yang ditentukan oleh DataFormatString properti diterapkan ke nilai bidang saat bidang data berada dalam mode edit.
ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai string kosong ("") secara otomatis dikonversi menjadi null saat bidang data diperbarui di sumber data.
DataFormatString	Mendapatkan atau mengatur format tampilan untuk nilai bidang.
HtmlEncode	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang harus dikodekan HTML.
NullDisplayText	Mendapatkan atau mengatur teks yang ditampilkan untuk bidang saat nilai bidang adalah null.
NullDisplayTextResourceType	Mendapatkan atau mengatur Type yang berisi sumber daya untuk NullDisplayText. Menggunakan NullDisplayTextResourceType bersama dengan NullDisplayText, memungkinkan GetNullDisplayText() metode untuk mengembalikan nilai yang dilokalkan.
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetNullDisplayText()	Mengembalikan string tampilan UI untuk NullDisplayText.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Cara: Mengatur Budaya dan Budaya UI untuk Globalisasi Halaman Web ASP.NET