Merhaba Webkolog okurları! Bugün C# .Net Framework 4 ve Visual Studio 2010 kullanarak uygulamalarımızda kullanıcı girişlerini doğrulamak ve hataları göstermek için kullandığımız ErrorProvider kontrolünü yakından inceleyeceğiz. ErrorProvider, özellikle formlardaki veri girişlerini kontrol etmek ve kullanıcılara anlaşılır hata mesajları sunmak için önemlidir. Gelin, bu kontrolün temel özelliklerine ve kullanımına birlikte göz atalım.
ErrorProvider Kontrolü
Nedir?
ErrorProvider kontrolü, bir kontrolle ilişkilendirilen
bir hata simgesi ve metin görüntüleyerek kullanıcıya hata bildirimleri
göstermeyi sağlar. Bu kontrol, genellikle formlardaki veri doğrulama
işlemlerinde kullanılır.
ErrorProvider Kontrolünü
Kullanma
- ErrorProvider Oluşturma:
- Visual Studio 2010'da, Toolbox'tan bir ErrorProvider kontrolünü
formunuza sürükleyerek veya kodda bir ErrorProvider nesnesi oluşturarak
başlayabilirsiniz.
- Hata Mesajı Ayarlama:
- SetError() metodu, bir kontrolle ilişkilendirilecek hata mesajını
ayarlamak için kullanılır. Bu metot, hangi kontrol için hangi hata
mesajının görüntüleneceğini belirtir.
Örnek Kullanım
Aşağıdaki örnekte, bir TextBox kontrolü için
ErrorProvider kullanmayı ve bazı özelliklerini ayarlamayı gösteriyoruz:
// ErrorProvider örneği
// Yanıp sönme hızını ayarlar (milisaniye cinsinden).
errorProvider1.BlinkRate = 250;
// Yanıp sönme stilini ayarlar.
errorProvider1.BlinkStyle = ErrorBlinkStyle.NeverBlink;
// TextBox1 için hata mesajını ayarlar.
errorProvider1.SetError(textBox1, "Hata Mesajı!");
// Hata simgesinin dolgusunu ayarlar (piksel cinsinden).
errorProvider1.SetIconPadding(textBox1, 20);
// Hata simgesinin hizalamasını ayarlar.
errorProvider1.SetIconAlignment(textBox1, ErrorIconAlignment.MiddleRight);
Bu örnekte, errorProvider1 adında bir ErrorProvider
oluşturduk. BlinkRate özelliği ile hata simgesinin yanıp sönme hızını,
BlinkStyle özelliği ile yanıp sönme stilini ayarladık. SetError() metodu ile
textBox1 kontrolü için bir hata mesajı belirledik. Ayrıca, SetIconPadding() ve
SetIconAlignment() metotları ile hata simgesinin konumunu ve dolgusunu
ayarladık.
ErrorBlinkStyle
Numaralandırması
ErrorBlinkStyle numaralandırması, hata simgesinin
nasıl yanıp söneceğini belirler:
- AlwaysBlink: Hata simgesi sürekli yanıp söner.
- BlinkIfDifferentError: Hata mesajı değiştiğinde yanıp söner.
- NeverBlink: Hata simgesi hiç yanıp sönmez.
ErrorProvider Kontrolünün
Özellikleri
- BlinkRate: Hata simgesinin yanıp sönme hızını milisaniye cinsinden belirtir.
- BlinkStyle: Hata simgesinin nasıl yanıp söneceğini belirler.
- Icon: Kullanılacak hata simgesini alır veya ayarlar.
- ContainerControl: ErrorProvider'ın ait olduğu контейнер kontrolünü
(genellikle bir Form) alır veya ayarlar.
ErrorProvider Kontrolünün
Metotları
- GetError(Control control): Belirtilen kontrolle ilişkilendirilmiş hata
mesajını alır.
- SetError(Control control, string text): Belirtilen kontrolle bir hata mesajı
ilişkilendirir.
- SetIconAlignment(Control control,
ErrorIconAlignment alignment): Hata simgesinin kontrol içindeki hizalamasını ayarlar.
- SetIconPadding(Control control, int padding): Hata simgesinin kontrol kenarından olan
uzaklığını piksel cinsinden ayarlar.
- Clear(): Tüm kontrollerle ilişkilendirilmiş hata mesajlarını temizler.
Örnek: Form Doğrulama
Aşağıdaki örnekte, bir formdaki TextBox kontrollerini
doğrulamayı ve ErrorProvider kullanarak hata mesajları göstermeyi ele alıyoruz:
private void btnKaydet_Click(object sender, EventArgs e)
{
bool hataVar = false;
if (string.IsNullOrWhiteSpace(txtAd.Text))
{
errorProvider1.SetError(txtAd, "Ad alanı boş olamaz!");
hataVar = true;
}
else
{
errorProvider1.SetError(txtAd, ""); // Hata yoksa hata mesajını temizle
}
if (string.IsNullOrWhiteSpace(txtSoyad.Text))
{
errorProvider1.SetError(txtSoyad, "Soyad alanı boş olamaz!");
hataVar = true;
}
else
{
errorProvider1.SetError(txtSoyad, "");
}
if (!txtEmail.Text.Contains("@"))
{
errorProvider1.SetError(txtEmail, "Geçerli bir e-posta adresi girin!");
hataVar = true;
}
else
{
errorProvider1.SetError(txtEmail, "");
}
if (!hataVar)
{
// Tüm alanlar geçerli, kaydetme işlemini gerçekleştir
MessageBox.Show("Kayıt Başarılı!");
}
}
Bu örnekte, "Kaydet" düğmesine
tıklanıldığında formdaki üç TextBox'ın içeriğini kontrol ediyoruz. Eğer bir
alan geçersizse, SetError() metodu ile ilgili TextBox için bir hata mesajı
ayarlıyoruz ve hataVar değişkenini true olarak ayarlıyoruz. Eğer tüm alanlar
geçerliyse, hata mesajlarını temizliyoruz ve kayıt işlemini gerçekleştiriyoruz.
Sevgili Webkolog okurları, C# .Net Framework 4 ve Visual Studio 2010 kullanarak ErrorProvider kontrolünün temel kullanımını ve bazı önemli özelliklerini bu şekilde incelemiş olduk. Bu kontrol, uygulamalarınızda kullanıcılarınıza etkili hata bildirimleri sunmanıza ve veri girişlerini doğrulamanıza yardımcı olur.
Webkolog'u takipte kalın!
Hepinize hatasız ve başarılı kodlama deneyimleri
dilerim!
0 yorum:
Yorum Gönder