ExceptionValidationRule Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Rappresenta una regola che controlla le eccezioni generate durante l'aggiornamento della proprietà di origine di associazione.

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

Esempio

La ValidationRules proprietà accetta una raccolta di ValidationRule oggetti . Nell'esempio seguente viene utilizzata TextBox.Text come proprietà di destinazione dell'associazione e StartPrice (un numero intero) come proprietà di origine dell'associazione. Quando l'utente immette un valore che non può essere convertito in un numero intero, viene generata un'eccezione che causa l'invalidare ExceptionValidationRule il valore di destinazione.

<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>

Per impostazione predefinita, quando si verifica un errore di convalida, viene TextBox visualizzato con un bordo rosso. Facoltativamente, è possibile scrivere un oggetto personalizzato ErrorTemplate per specificare la modalità di notifica all'utente quando si verifica un errore di convalida.

Per altre informazioni sulla convalida dei dati, vedere Panoramica del data binding.

Per l'esempio completo, vedere Demo di data binding.

Commenti

Il modello di data binding WPF consente di associare ValidationRules un Binding oggetto . La ExceptionValidationRule classe è una regola predefinita che controlla la presenza di eccezioni generate durante gli aggiornamenti della proprietà di origine dell'associazione. È possibile fornire logica personalizzata per specificare come il motore di associazione gestisce queste eccezioni usando un oggetto UpdateSourceExceptionFilterCallback. Per altre informazioni, vedere UpdateSourceExceptionFilter.

Una sintassi alternativa per impostare in modo esplicito ExceptionValidationRule consiste nell'impostare la proprietà ValidatesOnExceptions su true nell'oggetto Binding o MultiBinding.

È possibile creare una regola personalizzata creando una classe che deriva da ValidationRule. Per altre informazioni e una descrizione dettagliata della convalida dei dati, vedere Panoramica del data binding.

Costruttori

ExceptionValidationRule()

Inizializza una nuova istanza della classe ExceptionValidationRule.

Proprietà

ValidatesOnTargetUpdated

Ottiene o imposta un valore che indica se la regola di convalida viene eseguita all'aggiornamento della destinazione di Binding.

(Ereditato da ValidationRule)
ValidationStep

Ottiene o imposta il momento in cui viene eseguita la regola di convalida.

(Ereditato da ValidationRule)

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
Validate(Object, CultureInfo)

Esegue controlli di convalida su un valore.
Validate(Object, CultureInfo, BindingExpressionBase)

Esegue controlli di convalida su un valore.

(Ereditato da ValidationRule)
Validate(Object, CultureInfo, BindingGroup)

Esegue controlli di convalida su un valore.

(Ereditato da ValidationRule)

Si applica a

Vedi anche