ExceptionValidationRule Classe

  • Referência

Definição

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Representa uma regra que verifica exceções geradas durante a atualização da propriedade de fonte da associação.

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
Object
ValidationRule
ExceptionValidationRule

Exemplos

A ValidationRules propriedade usa uma coleção de ValidationRule objetos. O exemplo a seguir usa TextBox.Text como propriedade de destino de associação e StartPrice (um inteiro) como a propriedade de origem de associação. Quando o usuário insere um valor que não pode ser convertido em um inteiro, uma exceção é gerada, o que faz com que o ExceptionValidationRule valor de destino seja invalidado.

<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, ele TextBox aparece com uma borda vermelha. Opcionalmente, você pode escrever um personalizado ErrorTemplate para especificar como deseja notificar o usuário quando houver um erro de validação.

Para obter mais informações sobre a validação de dados, consulte a Visão geral da Associação de Dados.

Para obter o exemplo completo, consulte Demonstração de Associação de Dados.

Comentários

O modelo de associação de dados do WPF permite que você associe ValidationRules a um Binding objeto. A ExceptionValidationRule classe é uma regra interna que verifica se há exceções geradas durante as atualizações da propriedade de origem de associação. Você pode fornecer lógica personalizada para especificar como o mecanismo de associação lida com essas exceções usando um UpdateSourceExceptionFilterCallback. Para obter mais informações, consulte UpdateSourceExceptionFilter.

Uma sintaxe alternativa para definir explicitamente ExceptionValidationRule é definir a ValidatesOnExceptions propriedade true em seu Binding objeto ou MultiBinding objeto.

Você pode criar uma regra personalizada criando uma classe derivada de ValidationRule. Para obter mais informações e uma discussão detalhada sobre a validação de dados, consulte a Visão geral da Associação de Dados.

Construtores

ExceptionValidationRule()

Inicializa uma nova instância da classe ExceptionValidationRule.

Propriedades

ValidatesOnTargetUpdated

Obtém ou define um valor que indica se a regra de validação é executada quando o destino do Binding é atualizado.

(Herdado de ValidationRule)
ValidationStep

Obtém ou define quando a regra de validação é executada.

(Herdado de ValidationRule)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
Validate(Object, CultureInfo)

Executa as verificações de validação em um valor.
Validate(Object, CultureInfo, BindingExpressionBase)

Executa as verificações de validação em um valor.

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

Executa as verificações de validação em um valor.

(Herdado de ValidationRule)

Aplica-se a

Confira também