Eveniment FrameworkElement.BindingValidationError (System.Windows)

Apare cand o eroare de validare a datelor este raportata de o sursa de legare.

Sintaxa

‘Declaratie eveniment public BindingValidationError ca eveniment public EventHandler (Of ValidationErrorEventArgs) EventHandler <ValidationErrorEventArgs> BindingValidationError <frameworkElement BindingValidationError = “eventhandler” />

Utilizati un handler bazat pe EventHandler <TEventArgs> si constrans de ValidationErrorEventArgs pentru a gestiona acest eveniment.

Evenimentul BindingValidationError este un eveniment rutat. Aceasta inseamna ca, daca mai multi gestionari de evenimente BindingValidationError sunt inregistrati pentru o secventa de obiecte conectate prin relatii parinte-copil in arborele obiectului, evenimentul este primit de fiecare obiect din acea relatie. Evenimentul este ridicat de obiectul care primeste in mod direct conditia de intrare care initiaza evenimentul, si apoi „bule” la fiecare obiect parinte succesiv. Metafora clocotitoare indica faptul ca evenimentul incepe in partea de jos si se indreapta spre arborele obiectului. Pentru un eveniment rutat, expeditorul disponibil pentru gestionarul de evenimente identifica obiectul in care este tratat evenimentul, nu neaparat obiectul care a primit efectiv conditia de intrare care a initiat evenimentul. Pentru a obtine obiectul care a initiat evenimentul, utilizati valoarea OriginalSource a evenimentului ‘

Scenariul specific pentru rutare a unui eveniment BindingValidationError este acela ca puteti alege sa aveti un singur comportament de validare sau solicitare in interfata de utilizare pentru un set grupat de controale individuale care fiecare isi valideaza intrarea legata. Acest lucru este similar din punct de vedere conceptual cu modul in care in proiectarea tipica a paginilor web ar putea exista o singura cale de cod care proceseaza toate problemele de validare intr-un formular HTML si afiseaza fiecare eroare de validare intr-un format si o locatie UI comune. Daca alegeti acest design de a utiliza o rutina de validare comuna si o locatie UI, nu setati Handled la true in handlers BindingValidationError specifice controlului. Parintele din grupare nu ar putea sa-si execute propriul handler ca raspuns daca Handled de la evenimente ridicate de obiecte copil este deja adevarat.

Un autor de control nu ar trebui, in general, sa ridice sau sa gestioneze acest eveniment in proiectarea controlului si implementarea clasei de control. In schimb, motorul de legare proceseaza orice exceptii care sunt aruncate de o sursa de legare atunci cand incearca sa seteze sursa in legatura bidirectionala dintr-o utilizare a instantei de control. Pe baza de legare, legarea poate raporta astfel de exceptii ca o eroare obiectului care are proprietatea unde se aplica legarea. Acest comportament este activat prin setarea atat a NotifyOnValidationError, cat si a ValidatesOnExceptions la true la legare. O exceptie de setare sursa atunci cand o legare bidirectionala incearca sa posteze date nevalide la sursa va ridica apoi BindingValidationError din obiect.

Exemple

Urmatoarele exemple arata UI XAML care foloseste validarea, inclusiv elementul la care este atasata gestionarea BindingValidationError si codul de gestionare a validarii. Observati cum este atasat gestionarul BindingValidationError la nivelul StackPanel in loc de validarea elementului de text individual. Handlerul la nivelul StackPanel ar putea efectua validarea mai multor elemente copil, desi doar un singur element este validat in acest exemplu.

Informatii despre versiune

Silverlight

Suportat in: 5, 4, 3

Silverlight pentru Windows Phone

Suportat in: Windows Phone OS 7.1, Windows Phone OS 7.0

Vezi si

Referinta

Alte resurse