ExceptionValidationRule Classe

Definição

Espaço de Nomes:
System.Windows.Controls
Assemblagem:
PresentationFramework.dll

Representa uma regra que verifica exceções que são lançadas durante a atualização da propriedade de binding source.

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 reúne um conjunto de ValidationRule objetos. O exemplo seguinte usa TextBox.Text como propriedade de alvo de ligação e StartPrice (um inteiro) como propriedade de fonte de ligação. Quando o utilizador insere um valor que não pode ser convertido em inteiro, é lançada uma exceção, o que faz com que o ExceptionValidationRule invalide o valor alvo.

<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 defeito, quando há um erro de validação, aparece TextBox com uma borda vermelha. Opcionalmente, pode escrever um custom ErrorTemplate para especificar como pretende notificar o utilizador quando houver um erro de validação.

Para mais informações sobre validação de dados, consulte Visão Geral da Ligação de Dados.

Observações

O modelo de ligação de dados WPF permite-lhe associar ValidationRules a um objeto Binding. A ExceptionValidationRule classe é uma regra incorporada que verifica exceções lançadas durante as atualizações da propriedade de ligação fonte. Pode fornecer lógica personalizada para especificar como o motor de ligação lida com estas exceções usando um UpdateSourceExceptionFilterCallback. Para obter mais informações, veja UpdateSourceExceptionFilter.

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

Pode criar uma regra personalizada criando uma classe que deriva de ValidationRule. Para mais informações e uma discussão detalhada sobre validação de dados, consulte Visão Geral da Ligação de Dados.

Construtores

Name Description
ExceptionValidationRule()

Inicializa uma nova instância da ExceptionValidationRule classe.

Propriedades

Name Description
ValidatesOnTargetUpdated

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

(Herdado de ValidationRule)
ValidationStep

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

(Herdado de ValidationRule)

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
Validate(Object, CultureInfo, BindingExpressionBase)

Realiza verificações de validação sobre um valor.

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

Realiza verificações de validação sobre um valor.

(Herdado de ValidationRule)
Validate(Object, CultureInfo)

Realiza verificações de validação sobre um valor.

Aplica-se a

Ver também