Validation.Errors Propriedade anexada

Definição

Obtém a coleção de todos os objetos ValidationError ativos no elemento associado.

see GetErrors
see GetErrors
see GetErrors

Comentários

O aplicativo não pode modificar o conteúdo desta coleção. Consulte a seção Exemplo para obter um exemplo de como usar essa propriedade anexada.

O modelo de associação de dados do WPF permite que você associe ValidationRules ao seu Binding objeto. A validação ocorre durante a vinculação da transferência de valor de origem de destino para associação antes que o conversor seja chamado. O seguinte descreve o processo de validação:

  1. Quando um valor está sendo transferido da propriedade de destino para a propriedade de origem, o mecanismo de associação de dados primeiro remove qualquer ValidationError um que possa ter sido adicionado à System.Windows.Controls.Validation.Errors propriedade anexada do elemento associado. Em seguida, ele verifica se há algum s personalizado ValidationRuledefinido para esse Binding, nesse caso, ele chama o Validate método em cada um dos ValidationRules até que um deles seja executado em um erro ou até que todos eles passem.

  2. Depois que há uma regra personalizada que não passa, o mecanismo de associação cria um ValidationError objeto e o System.Windows.Controls.Validation.Errors adiciona à coleção do elemento associado. Quando System.Windows.Controls.Validation.Errors não estiver vazio, a System.Windows.Controls.Validation.HasError propriedade anexada do elemento será definida truecomo . Além disso, se a propriedade NotifyOnValidationError do Binding estiver definida como true, o mecanismo de associação gerará o evento anexado System.Windows.Controls.Validation.Error no elemento.

  3. Se todas as regras forem aprovadas, o mecanismo de associação chamará o conversor, se houver.

  4. Se o conversor for aprovado, o mecanismo de associação chamará o setter da propriedade de origem.

  5. Se a associação tiver um ExceptionValidationRule associado a ele e uma exceção for gerada durante a etapa 4, o mecanismo de associação verificará se há um UpdateSourceExceptionFilter. Você tem a opção de usar o UpdateSourceExceptionFilter retorno de chamada para fornecer um manipulador personalizado para lidar com exceções. Se um UpdateSourceExceptionFilter não for especificado no Binding, o mecanismo de associação criará um ValidationError com a exceção e o System.Windows.Controls.Validation.Errors adicionará à coleção do elemento associado.

Observe também que uma transferência de valor válida em qualquer direção (de destino para origem ou de origem para destino) limpa o Validation.Errorspropriedade anexada.

Para obter informações sobre o comportamento dessa propriedade em MultiBinding cenários, consulte ValidationError.

Para obter mais informações, confira "Validação de dados" em Visão geral da associação de dados.

Uso de texto XAML

Consulte Observações. A Errors coleção em si não é configurável pelo usuário, mas você pode usá-la em uma definição de modelo de controle em XAML.

Informações da propriedade de dependência

Campo Identificador ErrorsProperty
Propriedades de metadados definidas como true IsNotDataBindable

Aplica-se a