DisplayFormatAttribute Sınıf

Tanım

Ad Alanı:

System.ComponentModel.DataAnnotations

Bütünleştirilmiş Kod:

System.ComponentModel.Annotations.dll

Kaynak:

DisplayFormatAttribute.cs

Veri alanlarının ASP.NET Dinamik Veri tarafından nasıl görüntüleneceğini ve biçimlendirildiğini belirtir.

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

Devralma

Object

Attribute

DisplayFormatAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Bu özelliğin çevrimiçi örneğine bakın: Çalıştır.

Aşağıdaki örnekte, bir veri alanının biçimlendirmesini DisplayFormatAttribute özelleştirmek için öğesinin nasıl kullanılacağı gösterilmektedir. Örnek aşağıdaki adımları gerçekleştirir:

• Bir meta veri kısmi sınıfı ve ilişkili bir meta veri sınıfı uygular.

• İlişkili meta veri sınıfında özniteliğini DisplayFormatAttribute uygulayarak aşağıdaki sonuçları belirtir:

  • Veri alanı boş olduğunda "[Null]" metnini görüntüleyin.

  • Para birimi verilerini yerel ayara özgü para birimi biçiminde görüntüleyin.

  • Tarih bilgilerini kısa biçimde (aa/gg/yy) görüntüler. Bu biçim düzenleme modunda da geçerlidir.

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

Örneği derlemek için aşağıdakiler gerekir:

• Visual Studio 2010 veya sonraki sürümleri.

• AdventureWorksLT örnek veritabanı. SQL Server örnek veritabanını indirme ve yükleme hakkında bilgi için bkz. Microsoft SQL Server Ürün Örnekleri: GitHub'da Veritabanı. Çalıştırdığınız SQL Server sürümü için örnek veritabanının doğru sürümünü yüklediğinizden emin olun.

• Veri temelli bir Web sitesi. Bu, veritabanı ve özelleştirebileceğiniz veri alanını içeren sınıf için bir veri bağlamı oluşturmanıza olanak tanır. Daha fazla bilgi için bkz. Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Açıklamalar

Bu özniteliği bir veri alanına uyguladığınızda, özniteliklerin kullanımına yönelik yönergeleri izlemeniz gerekir. Daha fazla bilgi için bkz. ASP.NET Dinamik Veri Yönergeleri.

Oluşturucular

DisplayFormatAttribute()

DisplayFormatAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

ApplyFormatInEditMode	Veri alanı düzenleme modundayken, özelliği tarafından belirtilen biçimlendirme dizesinin DataFormatString alan değerine uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar.
ConvertEmptyStringToNull	Veri alanı veri kaynağında güncelleştirildiğinde boş dize değerlerinin ("") otomatik olarak dönüştürülip dönüştürülmeyeceğini null belirten bir değeri alır veya ayarlar.
DataFormatString	Alan değeri için görüntüleme biçimini alır veya ayarlar.
HtmlEncode	Alanın HTML ile kodlanmış olması gerekip gerekmediğini belirten bir değer alır veya ayarlar.
NullDisplayText	Alanın değeri nullolduğunda bir alan için görüntülenen metni alır veya ayarlar.
NullDisplayTextResourceType	için NullDisplayTextkaynakları içeren öğesini alır veya ayarlarType. NullDisplayTextResourceType ile NullDisplayTextbirlikte kullanıldığında yöntemin GetNullDisplayText() yerelleştirilmiş değerler döndürmesine olanak tanır.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetNullDisplayText()	için NullDisplayTextkullanıcı arabirimi görüntüleme dizesini döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Nasıl yapılır: ASP.NET Web Sayfası Genelleştirmesi için Kültür ve Kullanıcı Arabirimi Kültürünü Ayarlama