MVC Data Annotations Nedir? Nasıl Kullanılır?

Eğer ErrorMessage tanımlamasakdık otomatik olarak şöyle bir cümle tanımlanmış ve gösterilmiş olacaktı “The Ad field is required.” null veya boş değer girilmeye çalışıldığında bu hata ile karşılaşmanız olasıdır.

Bu niteliği kullandığımız özellik değiştirelemez, sadece görüntülenir. Kullanımı;

Model özelliğini formatlı göstermek için kullanabiliriz. Örneğin;

Şeklinde bir kullanımda, bu alanın çıktısı şöyle olacaktır:

12.50 TL

ApplyFormatInEditMode özelliği varsayılan olarak false dur. Eğer bu formatlı görüntünün input içerisinde de görünmesini istiyorsak true yaparız.

Şimdi ise DogumTarihini dd/MM/yyyy formatında yazdıralım eğer format belirtmezsek dd/MM/yyyy hh:mm:nn formatında uzunca gereksiz rakamlar çıkacaktır.

Tarih için üstteki formatı kullanırsanız çıktı şu şekilde olacaktır.

02-08-2014

NullDisplayText özelliğini kullanarak NULL dönen sonuçlar yerine bir not gösterilmesini sağlayabilirsiniz.

Bu nitelik ile girilecek değerin karakter uzunluğunu belirleriz. Bu tanımlama ile aynı zamanda Code First geliştirmede veritabanın oluşturulacak alan içinde, bu string uzunluğu tanımlanacaktır.

şeklinde bir tanımlama yaptığımızda, 50 karakterden fazla bir girdi yazarsak alacağımız mesaj;

gibi olacaktır. Ayrıca veritabanı tablosundaki ad alanının görüntüsüde aşağıdaki gibidir.

MinimumLength özelliğide isteğe bağlıdır. Bu özellik StringLength nitaliğine bağlı bir özelliktir. Kullanımıda aşağıdaki gibidir.

Regex tüm dillerde olan bir string doğrulama desenidir. MVC de de regex için bir nitelik (attribute) vardır. Regex girilen string değerin, bizim belirlediğimiz bir kurala göre olup olmadıgını belirlemek amaçlı kullanılır.

Aslında bir mail adresinin gerçek olup olmadığı o adrese mail atıp cevap gelene kadar beklemeden anlaşılmaz. Ama en azından belli bir e-posta deseni vardır. @ sembolune kadar olan kısım kullanıcı kimligi, bu sembolden sonra, mail sirketinin kimliği, daha sonra bir nokta ve bir uzantı.

E-posta adresinin regex deseni [A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+.[A-Za-z]{2,4} şeklindedir. Bunu sınıfımızın özelliği için nitelik olarak belirlemek için;

şeklinde kullanırız. Böylece MVC kullanıcı girdisinin bu desene uyup uymadıgını kontrol eder. Ve önceki örneklerimizde olduğu gibi bir hata mesajı verir. Tabi aslında Email için direk yazılmış nitalik var. Bunlara de deyineceğiz.

Bu nitelik sayısal değerler için aralık belirlemek için kullanılır. Örneğin bir yaş aralığı için; Bu nitelik, sunucu taraflı bir çağrı ile istemci taraflı bir doğrulama yapmak amacıyla kullanılır. Yani; örneğin, KullaniciAdi var mı yok mu diye, kontrol etmek için veritabanına gitmek gerekli. Bunu yaparken ise istemci taraflı bir doğrulama yapmak için bu niteliği kullanabiliriz. Örneğin kategori ismi için, aynı kategoriyi tekrar girilmesini istemiyorsak, kategori sınıfımızdaki Ad alanını Remote ekliyoruz;

Daha sonra KategoriController sınıfına aşağıdaki metodu ekliyoruz.

Kategori eğer sistemde varsa, sayfa yenilemesi olmadan bu karşılaştırma yapılarak, hata mesajı verecektir. Hata mesajı aşağıdaki gibidir.

Range attribute’ünü özellikle yaş gibi bu durumlarda kullanabilirsiniz mesela projenizde kayıt işleminde yaş aralığı 18-65 arasındaki kişileri kabul ediyorsanız aşağıdaki gibi bir rande kullanımı tam ihtiyacınızı karşılayacaktır.

Eğer iki tarih aralığında bir tarih girilmesini istersek o zaman aşağıdaki gibi bir yazım ile ihtiyacımızı karşılayabiliriz.

Üstteki kodda yapılmak istenen çok basit DateTime türünde 01/01/2000 ile 01/01/2010 tarihleri arasındaki bir tarih girdirilmesini sağlayabiliriz kolaylıkla.

Bu nitelik ile örneğin kullanıcı şifresini tekrar girmesini istedigimizde bu iki şifre karşılaştırılır. Örnek kullanımı;

şeklinde bir tanımlama yaparsak, iki textbox içine girilen değerler otomatik olarak karşılaştırılır.

Düzenlenmesini istemediğimiz model özelliği için kullanılır. Böylece bu alan EditorForModel kullandığımızda gizlenecektir. Örneğin, modelin id sini kendimiz belirlemiyoruz. Bu özelliği veritabanına bırakıyoruz. Dolayısıyla bu alan için ScaffoldColumn niteliği kullanabiliriz. Örnek kullanımı;