Bagikan melalui


DisplayFormatAttribute Kelas

Definisi

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

Contoh

Lihat contoh online fitur ini: Jalankan.

Contoh berikut menunjukkan cara menggunakan untuk mengkustomisasi DisplayFormatAttribute 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 disesuaikan. Untuk informasi selengkapnya, lihat Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Keterangan

Saat Menerapkan atribut ini ke bidang data, Anda harus mengikuti panduan 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 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 yang saat ini Object.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

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

Memetakan sekumpulan nama ke sekumpulan pengidentifikasi pengiriman yang sesuai.

(Diperoleh dari Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Mengambil informasi jenis untuk objek, yang dapat digunakan untuk mendapatkan informasi jenis untuk antarmuka.

(Diperoleh dari Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Mengambil jumlah antarmuka informasi jenis yang disediakan objek (baik 0 atau 1).

(Diperoleh dari Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Menyediakan akses ke properti dan metode yang diekspos oleh objek.

(Diperoleh dari Attribute)

Berlaku untuk

Lihat juga