Binding.ValidatesOnExceptions Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, следует ли включать .ExceptionValidationRule
public:
property bool ValidatesOnExceptions { bool get(); void set(bool value); };
public bool ValidatesOnExceptions { get; set; }
member this.ValidatesOnExceptions : bool with get, set
Public Property ValidatesOnExceptions As Boolean
Значение свойства
trueЗначение , ExceptionValidationRuleчтобы включить значение false; в противном случае .
Примеры
В следующих примерах используется ValidatesOnExceptions проверка входных данных пользователей в объекте TextBox. В первом примере создается тип данных, который создает исключение, если Age для свойства задано недопустимое свойство.
public class PersonThrowException
{
private int age;
public int Age
{
get { return age; }
set
{
if (value < 0 || value > 150)
{
throw new ArgumentException("Age must not be less than 0 or greater than 150.");
}
age = value;
}
}
}
Public Class PersonThrowException
Private m_age As Integer
Public Property Age() As Integer
Get
Return m_age
End Get
Set(ByVal value As Integer)
If value < 0 OrElse value > 150 Then
Throw New ArgumentException("Age must not be less than 0 or greater than 150.")
End If
m_age = value
End Set
End Property
End Class
В следующем примере свойство привязывается Age к TextBox свойству и задает ValidatesOnExceptions значение true для объекта Binding. Когда пользователь вводит недопустимое значение, красная граница отображается в сообщении TextBoxToolTip об ошибке.
<StackPanel Margin="20">
<StackPanel.Resources>
<src:PersonThrowException x:Key="data"/>
<!--The tool tip for the TextBox to display the validation error message.-->
<Style x:Key="textBoxInError" TargetType="TextBox">
<Style.Triggers>
<Trigger Property="Validation.HasError" Value="true">
<Setter Property="ToolTip"
Value="{Binding RelativeSource={x:Static RelativeSource.Self},
Path=(Validation.Errors)[0].ErrorContent}"/>
</Trigger>
</Style.Triggers>
</Style>
</StackPanel.Resources>
<TextBlock>Enter your age:</TextBlock>
<TextBox Style="{StaticResource textBoxInError}">
<TextBox.Text>
<!--By setting ValidatesOnExceptions to True, it checks for exceptions
that are thrown during the update of the source property.
An alternative syntax is to add <ExceptionValidationRule/> within
the <Binding.ValidationRules> section.-->
<Binding Path="Age" Source="{StaticResource data}"
ValidatesOnExceptions="True"
UpdateSourceTrigger="PropertyChanged">
</Binding>
</TextBox.Text>
</TextBox>
<TextBlock>Mouse-over to see the validation error message.</TextBlock>
</StackPanel>
Комментарии
Установка этого свойства предоставляет альтернативу использованию ExceptionValidationRule элемента явным образом. Это ExceptionValidationRule встроенное правило проверки, которое проверяет наличие исключений, которые возникают во время обновления исходного свойства. Если создается исключение, подсистема привязки создает ValidationError исключение и добавляет его в Validation.Errors коллекцию привязанного элемента. Отсутствие ошибки очищает эту обратную связь проверки, если другое правило не вызывает проблему проверки.
ValidatesOnExceptions представлен в .NET Framework версии 3.5. Для получения дополнительной информации см. Версии и зависимости .NET Framework.