ExceptionValidationRule Classe

Definição

Representa uma regra que verifica exceções geradas durante a atualização da propriedade de fonte da associação.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
Herança
ExceptionValidationRule

Exemplos

A ValidationRules propriedade usa uma coleção de ValidationRule objetos.The ValidationRules property takes a collection of ValidationRule objects. O exemplo a seguir TextBox.Text usa como a propriedade de destino StartPrice de associação e (um inteiro) como a propriedade de origem da associação.The following example uses TextBox.Text as the binding target property and StartPrice (an integer) as the binding source property. Quando o usuário insere um valor que não pode ser convertido em um inteiro, uma exceção é lançada, o que ExceptionValidationRule faz com que o invalidar o valor de destino.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>

Por padrão, quando há um erro de validação, o TextBox é exibido com uma borda vermelha.By default, when there is a validation error, the TextBox appears with a red border. Opcionalmente, você pode escrever um personalizado ErrorTemplate para especificar como deseja notificar o usuário quando houver um erro de validação.Optionally, you can write a custom ErrorTemplate to specify how you want to notify the user when there is a validation error.

Para obter mais informações sobre validação de dados, consulte visão geral da ligação de dados.For more information about data validation, see Data Binding Overview.

Para obter o exemplo completo, consulte demonstração de ligação de dados.For the complete sample, see Data Binding Demo.

Comentários

O WPFWPF modelo de associação de dados permite que ValidationRules você associe Binding a um objeto.The WPFWPF data binding model enables you to associate ValidationRules with a Binding object. A ExceptionValidationRule classe é uma regra interna que verifica as exceções que são geradas durante as atualizações da propriedade de origem da associação.The ExceptionValidationRule class is a built-in rule that checks for exceptions that are thrown during the updates of the binding source property. Você pode fornecer uma lógica personalizada para especificar como o mecanismo de associação trata essas exceções usando UpdateSourceExceptionFilterCallbackum.You can provide custom logic to specify how the binding engine handles these exceptions by using a UpdateSourceExceptionFilterCallback. Para obter mais informações, consulte UpdateSourceExceptionFilter.For more information, see UpdateSourceExceptionFilter.

Uma sintaxe alternativa para definir ExceptionValidationRule explicitamente é definir a ValidatesOnExceptions Propriedade como true no seu Binding objeto or MultiBinding .An alternative syntax to setting the ExceptionValidationRule explicitly is to set the ValidatesOnExceptions property to true on your Binding or MultiBinding object.

Você pode criar uma regra personalizada criando uma classe derivada de ValidationRule.You can create a custom rule by creating a class that derives from ValidationRule. Para obter mais informações e uma discussão detalhada sobre a validação de dados, consulte visão geral da ligação de dados.For more information and a detailed discussion of data validation, see Data Binding Overview.

Construtores

ExceptionValidationRule()

Inicializa uma nova instância da classe ExceptionValidationRule.Initializes a new instance of the ExceptionValidationRule class.

Propriedades

ValidatesOnTargetUpdated

Obtém ou define um valor que indica se a regra de validação é executada quando o destino do Binding é atualizado.Gets or sets a value that indicates whether the validation rule runs when the target of the Binding is updated.

(Herdado de ValidationRule)
ValidationStep

Obtém ou define quando a regra de validação é executada.Gets or sets when the validation rule runs.

(Herdado de ValidationRule)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
Validate(Object, CultureInfo)

Executa as verificações de validação em um valor.Performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase)

Executa as verificações de validação em um valor.Performs validation checks on a value.

(Herdado de ValidationRule)
Validate(Object, CultureInfo, BindingGroup)

Executa as verificações de validação em um valor.Performs validation checks on a value.

(Herdado de ValidationRule)

Aplica-se a

Veja também