Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe ExceptionValidationRule

Representa uma regra que verifica para exceções lançadas durante a atualização da a origem de ligação propriedade.

System.Object
  System.Windows.Controls.ValidationRule
    System.Windows.Controls.ExceptionValidationRule

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (em PresentationFramework.dll)
XMLNS para XAML http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public sealed class ExceptionValidationRule : ValidationRule
<ExceptionValidationRule .../>

O tipo ExceptionValidationRule expõe os membros a seguir.

  NomeDescrição
Método públicoExceptionValidationRuleInicializa uma nova instância da classe ExceptionValidationRule.
Superior

  NomeDescrição
Propriedade públicaValidatesOnTargetUpdatedObtém ou define um valor que indica se a regra de validação é executada quando o destino da Binding é atualizado. (Herdado de ValidationRule.)
Propriedade públicaValidationStepObtém ou define quando a regra de validação é executada. (Herdado de ValidationRule.)
Superior

  NomeDescrição
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Método públicoValidate(Object, CultureInfo)Executa verificações de validação em um valor. (Substitui ValidationRule.Validate(Object, CultureInfo).)
Método públicoValidate(Object, CultureInfo, BindingExpressionBase)Executa verificações de validação em um valor. (Herdado de ValidationRule.)
Método públicoValidate(Object, CultureInfo, BindingGroup)Executa verificações de validação em um valor. (Herdado de ValidationRule.)
Superior

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

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

Você pode criar uma regra personalizada, criando uma classe que deriva de ValidationRule. Para obter mais informações e uma discussão detalhada de validação de dados, consulte Visão geral da vinculação de dados.

O ValidationRules propriedade tem uma coleção de ValidationRule objetos. O exemplo a seguir usa TextBox.Text como o destino de vinculação propriedade e StartPrice (um inteiro) como o a origem de ligação propriedade. Quando o usuário insere um valor que não pode ser convertido para um inteiro, uma exceção é lançada, que faz com que o ExceptionValidationRule para invalidar o valor de destino.


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

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

Para obter o exemplo completo, consulte A demonstração de ligação de dados.

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Qualquer estático (Shared no Visual Basic) membro público desse tipo é thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft