ExceptionValidationRule Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje regułę, która sprawdza wyjątki zgłaszane podczas aktualizacji właściwości źródłowej powiązania.
public ref class ExceptionValidationRule sealed : System::Windows::Controls::ValidationRule
public sealed class ExceptionValidationRule : System.Windows.Controls.ValidationRule
type ExceptionValidationRule = class
inherit ValidationRule
Public NotInheritable Class ExceptionValidationRule
Inherits ValidationRule
- Dziedziczenie
Przykłady
Właściwość ValidationRules przyjmuje kolekcję ValidationRule obiektów. W poniższym przykładzie użyto TextBox.Text jako właściwości docelowej powiązania i StartPrice
(liczby całkowitej) jako właściwości źródłowej powiązania. Gdy użytkownik wprowadzi wartość, której nie można przekonwertować na liczbę całkowitą, zgłaszany jest wyjątek, co powoduje ExceptionValidationRule unieważnienie wartości docelowej.
<TextBox Name="StartPriceEntryForm" Grid.Row="2" Grid.Column="1"
Style="{StaticResource textStyleTextBox}" Margin="8,5,0,5">
<TextBox.Text>
<Binding Path="StartPrice" UpdateSourceTrigger="PropertyChanged">
<Binding.ValidationRules>
<ExceptionValidationRule />
</Binding.ValidationRules>
</Binding>
</TextBox.Text>
</TextBox>
Domyślnie, gdy wystąpi błąd walidacji, TextBox zostanie wyświetlony z czerwonym obramowaniem. Opcjonalnie możesz napisać niestandardowy element ErrorTemplate , aby określić sposób powiadamiania użytkownika o błędzie weryfikacji.
Aby uzyskać więcej informacji na temat walidacji danych, zobacz Omówienie powiązania danych.
Aby zapoznać się z kompletnym przykładem, zobacz Pokaz powiązania danych.
Uwagi
Model powiązania danych WPF umożliwia skojarzenie ValidationRules z obiektem Binding . Klasa ExceptionValidationRule jest wbudowaną regułą, która sprawdza wyjątki zgłaszane podczas aktualizacji właściwości źródłowej powiązania. Możesz podać logikę niestandardową, aby określić sposób obsługi tych wyjątków przez aparat powiązań przy użyciu elementu UpdateSourceExceptionFilterCallback. Aby uzyskać więcej informacji, zobacz UpdateSourceExceptionFilter.
Alternatywna składnia jawnego ustawiania ExceptionValidationRule polega na ustawieniu właściwości ValidatesOnExceptions na wartość true
w obiekcie Binding lub MultiBinding.
Regułę niestandardową można utworzyć, tworząc klasę pochodzącą z ValidationRuleklasy . Aby uzyskać więcej informacji i szczegółową dyskusję na temat weryfikacji danych, zobacz Omówienie powiązania danych.
Konstruktory
ExceptionValidationRule() |
Inicjuje nowe wystąpienie klasy ExceptionValidationRule. |
Właściwości
ValidatesOnTargetUpdated |
Pobiera lub ustawia wartość wskazującą, czy reguła sprawdzania poprawności jest uruchamiana po zaktualizowaniu Binding obiektu docelowego. (Odziedziczone po ValidationRule) |
ValidationStep |
Pobiera lub ustawia po uruchomieniu reguły sprawdzania poprawności. (Odziedziczone po ValidationRule) |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Validate(Object, CultureInfo, BindingExpressionBase) |
Przeprowadza sprawdzanie poprawności wartości. (Odziedziczone po ValidationRule) |
Validate(Object, CultureInfo, BindingGroup) |
Przeprowadza sprawdzanie poprawności wartości. (Odziedziczone po ValidationRule) |
Validate(Object, CultureInfo) |
Przeprowadza sprawdzanie poprawności wartości. |