C# ile ErrorProvider

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

1. 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.
2. 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!