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

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, aşağıdaki sonuçları belirtmek için özniteliğini uygular DisplayFormatAttribute :

  • 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ğıdakilere ihtiyacınız vardır:

• 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. GitHub üzerinde Microsoft SQL Server Ürün Örnekleri: 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.

Oluşturucular

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

Özellikler

Name	Description
ApplyFormatInEditMode	Veri alanı düzenleme modundayken özellik tarafından belirtilen biçimlendirme dizesinin DataFormatString alan değerine uygulanıp uygulanmadığını gösteren bir değer alır veya ayarlar.
ConvertEmptyStringToNull	Veri kaynağında veri alanı güncelleştirildiğinde boş dize değerlerinin ("") otomatik olarak dönüştürülerek dönüştürülmeyeceğini null belirten bir değer 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 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 kullanmak, yönteminin 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

Name	Description
Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute)
GetNullDisplayText()	için NullDisplayTextkullanıcı arabirimi görüntüleme dizesini döndürür.
GetType()	Geçerli örneğin Type 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 Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)