Helyezzünk egy ErrorProvider komponenst a Form-ra. Ezt követően egy tetszőleges ponton elvégezhetjük a hibaellenőrzést.
private void button1_Click(object sender, System.EventArgs e)
{
string msg = "Kötelezően kitöltendő mező!";
if (textBox1.Text == String.Empty)
{
Ha hibát találunk, akkor a komponens SetError függvényét kell meghívnunk. Ennek első paraméterében azt a kontrolt kell megadnunk, melyben a hibás adat van. A második paraméterben a szöveges hibaüzenetet kell átadnunk. Ennek eredményeképpen a megadott kontrol mellett megjelenik egy kis ikon a hibát jelezve. Ha a felhasználó egérrel az ikon fölé áll, akkor egy kis súgó szövegben jelenik meg a második paraméterben megadott hibaüzenet.
errorProvider1.SetError(textBox1, msg);
}
else
{
A megjelenített hiba kis ikonja mindaddig látható marad, míg nem töröljük az adott kontrolhoz rendelt hiba szövegét.
errorProvider1.SetError(textBox1, String.Empty);
}
A megjelenítendő kis ikon képét a kontrol Icon property-jén keresztül adhatjuk meg.
Az ikon villogásának sebességét a BlinkRate property határozza meg, míg a villogás stílusát a BlinkStyle property-ben adhatjuk meg. Ennek értéke az alábbiak egyike lehet:
- AlwaysBlink - folyamatosan villog
- BlinkIfDifferentError - akkor villog, ha már van hiba jelzés, de egy újabb hiba kerül hozzárendelésre
- NeverBlink - nem villog.
A SetIconAlignment függvénnyel előírhatjuk, hogy az ikon a kontrol melyik oldalán jelenjen meg. Alapértelmezésben mindig annak jobb oldalán függőlegesen középre igazítva lesz látható.
A SetIconPadding függvénnyel a kontrol és az ikon közötti távolság állítható.
Amikor a Form-ra elhelyezünk egy ErrorProvider kontrolt, akkor a Form-on lévő kontrolok új property-t kapnak, ez jól látható, ha kiválasztunk mondjuk egy TextBox-ot, akkor annak Appearance csoportjában a következő property-k jelennek meg:
- Error on errorProvider1 - itt megadható a hibaüzenet
- IconAlignment on errorProvider1 - az ikon helyzete a kontrolhoz képest
- IconPadding on errorProvider1 - az ikon távolsága a kontroltól.