ExceptionValidationRule Classe

Definizione

Rappresenta una regola che controlla le eccezioni generate durante l'aggiornamento della proprietà di origine di associazione.Represents a rule that checks for exceptions that are thrown during the update of the binding source property.

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

Esempio

La ValidationRules proprietà accetta una raccolta di ValidationRule oggetti.The ValidationRules property takes a collection of ValidationRule objects. Nell'esempio seguente viene utilizzata la proprietà TextBox.Text di destinazione del binding e StartPrice (un Integer) come proprietà di origine dell'associazione.The following example uses TextBox.Text as the binding target property and StartPrice (an integer) as the binding source property. Quando l'utente immette un valore che non può essere convertito in un numero intero, viene generata un'eccezione che determina l' ExceptionValidationRule invalidamento del valore di destinazione.When the user enters a value that cannot be converted to an integer, an exception is thrown, which causes the ExceptionValidationRule to invalidate the target value.

<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, TextBox viene visualizzato con un bordo rosso.By default, when there is a validation error, the TextBox appears with a red border. Facoltativamente, è possibile scrivere un personalizzato ErrorTemplate per specificare come si desidera inviare una notifica all'utente quando si verifica un errore di convalida.Optionally, you can write a custom ErrorTemplate to specify how you want to notify the user when there is a validation error.

Per ulteriori informazioni sulla convalida dei dati, vedere Cenni preliminari sul data binding.For more information about data validation, see Data Binding Overview.

Per l'esempio completo, vedere Demo sull'associazione dati.For the complete sample, see Data Binding Demo.

Commenti

Il WPFWPF modello di data binding consente di associare ValidationRules un oggetto a un Binding oggetto.The WPFWPF data binding model enables you to associate ValidationRules with a Binding object. La ExceptionValidationRule classe è una regola predefinita che controlla le eccezioni generate durante gli aggiornamenti della proprietà di origine dell'associazione.The ExceptionValidationRule class is a built-in rule that checks for exceptions that are thrown during the updates of the binding source property. È possibile fornire la logica personalizzata per specificare il modo in cui il motore di associazione gestisce queste eccezioni usando un UpdateSourceExceptionFilterCallback .You can provide custom logic to specify how the binding engine handles these exceptions by using a UpdateSourceExceptionFilterCallback. Per altre informazioni, vedere UpdateSourceExceptionFilter.For more information, see UpdateSourceExceptionFilter.

Una sintassi alternativa per impostare in ExceptionValidationRule modo esplicito è l'impostazione della ValidatesOnExceptions proprietà true su sull' Binding MultiBinding oggetto o.An alternative syntax to setting the ExceptionValidationRule explicitly is to set the ValidatesOnExceptions property to true on your Binding or MultiBinding object.

È possibile creare una regola personalizzata creando una classe che deriva da ValidationRule .You can create a custom rule by creating a class that derives from ValidationRule. Per ulteriori informazioni e per una descrizione dettagliata della convalida dei dati, vedere Cenni preliminari sul data binding.For more information and a detailed discussion of data validation, see Data Binding Overview.

Costruttori

ExceptionValidationRule()

Inizializza una nuova istanza della classe ExceptionValidationRule.Initializes a new instance of the ExceptionValidationRule class.

Proprietà

ValidatesOnTargetUpdated

Ottiene o imposta un valore che indica se la regola di convalida viene eseguita all'aggiornamento della destinazione di Binding.Gets or sets a value that indicates whether the validation rule runs when the target of the Binding is updated.

(Ereditato da ValidationRule)
ValidationStep

Ottiene o imposta il momento in cui viene eseguita la regola di convalida.Gets or sets when the validation rule runs.

(Ereditato da ValidationRule)

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
Validate(Object, CultureInfo)

Esegue controlli di convalida su un valore.Performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase)

Esegue controlli di convalida su un valore.Performs validation checks on a value.

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

Esegue controlli di convalida su un valore.Performs validation checks on a value.

(Ereditato da ValidationRule)

Si applica a

Vedi anche