ExceptionValidationRule Klasa

Definicja

Reprezentuje regułę, która sprawdza wyjątki, które są zgłaszane podczas aktualizacji właściwości źródła powiązania.Represents a rule that checks for exceptions that are thrown during the update of the binding source property.

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
ExceptionValidationRule

Przykłady

ValidationRulesWłaściwość przyjmuje kolekcję ValidationRule obiektów.The ValidationRules property takes a collection of ValidationRule objects. Poniższy przykład używa TextBox.Text jako właściwości target powiązania i StartPrice (Integer) jako właściwość źródła powiązania.The following example uses TextBox.Text as the binding target property and StartPrice (an integer) as the binding source property. Gdy użytkownik wprowadzi wartość, której nie można przekonwertować na liczbę całkowitą, zostanie zgłoszony wyjątek, co spowoduje ExceptionValidationRule unieważnienie wartości docelowej.When the user enters a value that cannot be converted to an integer, an exception is thrown, which causes the ExceptionValidationRule to invalidate the target value.

<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ępuje błąd walidacji, TextBox pojawia się z czerwonym obramowaniem.By default, when there is a validation error, the TextBox appears with a red border. Opcjonalnie można napisać niestandardowy, ErrorTemplate Aby określić, w jaki sposób użytkownik ma zostać powiadomiony o błędzie walidacji.Optionally, you can write a custom ErrorTemplate to specify how you want to notify the user when there is a validation error.

Aby uzyskać więcej informacji na temat sprawdzania poprawności danych, zobacz temat powiązanie danych — omówienie.For more information about data validation, see Data Binding Overview.

Aby zapoznać się z kompletnym przykładem, zobacz Demonstracja powiązania danych.For the complete sample, see Data Binding Demo.

Uwagi

Model powiązania danych WPF umożliwia skojarzenie ValidationRules z Binding obiektem.The WPF data binding model enables you to associate ValidationRules with a Binding object. ExceptionValidationRuleKlasa jest wbudowaną regułą, która sprawdza wyjątki, które są zgłaszane podczas aktualizacji właściwości źródła powiązania.The ExceptionValidationRule class is a built-in rule that checks for exceptions that are thrown during the updates of the binding source property. Możesz podać logikę niestandardową, aby określić, jak aparat powiązania obsługuje te wyjątki przy użyciu UpdateSourceExceptionFilterCallback .You can provide custom logic to specify how the binding engine handles these exceptions by using a UpdateSourceExceptionFilterCallback. Aby uzyskać więcej informacji, zobacz UpdateSourceExceptionFilter.For more information, see UpdateSourceExceptionFilter.

Alternatywna składnia służąca do ustawienia ExceptionValidationRule jawnie polega na ustawieniu ValidatesOnExceptions właściwości na true Binding MultiBinding obiekt lub.An alternative syntax to setting the ExceptionValidationRule explicitly is to set the ValidatesOnExceptions property to true on your Binding or MultiBinding object.

Można utworzyć regułę niestandardową, tworząc klasę, która pochodzi od ValidationRule .You can create a custom rule by creating a class that derives from ValidationRule. Aby uzyskać więcej informacji i szczegółowe omówienie walidacji danych, zobacz temat powiązanie danych — omówienie.For more information and a detailed discussion of data validation, see Data Binding Overview.

Konstruktory

ExceptionValidationRule()

Inicjuje nowe wystąpienie klasy ExceptionValidationRule.Initializes a new instance of the ExceptionValidationRule class.

Właściwości

ValidatesOnTargetUpdated

Pobiera lub ustawia wartość wskazującą, czy reguła walidacji jest uruchamiana, gdy element docelowy Binding został zaktualizowany.Gets or sets a value that indicates whether the validation rule runs when the target of the Binding is updated.

(Odziedziczone po ValidationRule)
ValidationStep

Pobiera lub ustawia wartość określającą, kiedy zostanie uruchomiona reguła walidacji.Gets or sets when the validation rule runs.

(Odziedziczone po ValidationRule)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
Validate(Object, CultureInfo)

Wykonuje sprawdzanie poprawności dla wartości.Performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase)

Wykonuje sprawdzanie poprawności dla wartości.Performs validation checks on a value.

(Odziedziczone po ValidationRule)
Validate(Object, CultureInfo, BindingGroup)

Wykonuje sprawdzanie poprawności dla wartości.Performs validation checks on a value.

(Odziedziczone po ValidationRule)

Dotyczy

Zobacz też