ExceptionValidationRule Класс

Определение

Представляет правило для поиска исключений, возникающих во время обновления свойства источника привязки.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
Наследование
ExceptionValidationRule

Примеры

ValidationRules Свойство принимаетValidationRule коллекцию объектов.The ValidationRules property takes a collection of ValidationRule objects. В следующем примере в TextBox.Text качестве свойства источника привязки используется как StartPrice свойство цели привязки и (целое число).The following example uses TextBox.Text as the binding target property and StartPrice (an integer) as the binding source property. Когда пользователь вводит значение, которое не может быть преобразовано в целое число, создается исключение, которое приводит ExceptionValidationRule к недействительности целевого значения.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>

По умолчанию при ошибке TextBox проверки отображается красная граница.By default, when there is a validation error, the TextBox appears with a red border. При необходимости можно написать пользовательский ErrorTemplate параметр, чтобы указать способ уведомления пользователя при возникновении ошибки проверки.Optionally, you can write a custom ErrorTemplate to specify how you want to notify the user when there is a validation error.

Дополнительные сведения о проверке данных см. в разделе Общие сведения о привязке данных.For more information about data validation, see Data Binding Overview.

Полный пример см. в разделе Демонстрация привязки данных.For the complete sample, see Data Binding Demo.

Комментарии

Модель привязки ValidationRules данных позволяет связать с Binding объектом. WPFWPFThe WPFWPF data binding model enables you to associate ValidationRules with a Binding object. ExceptionValidationRule Класс является встроенным правилом, которое проверяет наличие исключений, возникающих во время обновления свойства источника привязки.The ExceptionValidationRule class is a built-in rule that checks for exceptions that are thrown during the updates of the binding source property. Вы можете предоставить настраиваемую логику, чтобы указать, как механизм привязки обрабатывает эти исключения UpdateSourceExceptionFilterCallbackс помощью.You can provide custom logic to specify how the binding engine handles these exceptions by using a UpdateSourceExceptionFilterCallback. Для получения дополнительной информации см. UpdateSourceExceptionFilter.For more information, see UpdateSourceExceptionFilter.

ExceptionValidationRule Альтернативный синтаксис для явной настройки заключается в true ValidatesOnExceptions присвоении свойству значения в Binding объекте MultiBinding или.An alternative syntax to setting the ExceptionValidationRule explicitly is to set the ValidatesOnExceptions property to true on your Binding or MultiBinding object.

Пользовательское правило можно создать, создав класс, производный от ValidationRule.You can create a custom rule by creating a class that derives from ValidationRule. Дополнительные сведения и подробное описание проверки данных см. в разделе Общие сведения о привязке данных.For more information and a detailed discussion of data validation, see Data Binding Overview.

Конструкторы

ExceptionValidationRule()

Инициализирует новый экземпляр класса ExceptionValidationRule.Initializes a new instance of the ExceptionValidationRule class.

Свойства

ValidatesOnTargetUpdated

Возвращает или задает значение, которое указывает, выполняется ли правило проверки, когда обновляется целевой объект Binding.Gets or sets a value that indicates whether the validation rule runs when the target of the Binding is updated.

(Унаследовано от ValidationRule)
ValidationStep

Возвращает или задает, когда выполняется правило проверки.Gets or sets when the validation rule runs.

(Унаследовано от ValidationRule)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
Validate(Object, CultureInfo)

Выполняет проверки по значению.Performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase)

Выполняет проверки по значению.Performs validation checks on a value.

(Унаследовано от ValidationRule)
Validate(Object, CultureInfo, BindingGroup)

Выполняет проверки по значению.Performs validation checks on a value.

(Унаследовано от ValidationRule)

Применяется к

Дополнительно