ValidationError ValidationError ValidationError ValidationError Class

Definición

Representa un error de validación creado por el motor de enlaces cuando ValidationRule notifica un error de validación, o bien, creado explícitamente a través del método MarkInvalid(BindingExpressionBase, ValidationError).Represents a validation error that is created either by the binding engine when a ValidationRule reports a validation error, or through the MarkInvalid(BindingExpressionBase, ValidationError) method explicitly.

public ref class ValidationError
public class ValidationError
type ValidationError = class
Public Class ValidationError
Herencia
ValidationErrorValidationErrorValidationErrorValidationError

Ejemplos

El ejemplo siguiente muestra un desencadenador de estilo que se crea un ToolTip que informa de un mensaje de error de validación.The following example shows a style trigger that creates a ToolTip that reports a validation error message. El Validation.Errors propiedad asociada devuelve una colección de ValidationError objetos en el elemento enlazado.The Validation.Errors attached property returns a collection of ValidationError objects on the bound element.

<Style x:Key="textStyleTextBox" TargetType="TextBox">
  <Setter Property="Foreground" Value="#333333" />
  <Setter Property="MaxLength" Value="40" />
  <Setter Property="Width" Value="392" />
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={RelativeSource Self},
                        Path=(Validation.Errors)[0].ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Comentarios

El WPFWPF modelo de enlace de datos le permite asociar las reglas de validación con su Binding objeto.The WPFWPF data binding model enables you to associate validation rules with your Binding object. Validación se produce durante la transferencia del valor de origen de destino antes de llama el convertidor.Validation occurs during target-to-source value transfer before the converter is called. El siguiente describe el proceso de validación.The following describes the validation process.

  1. Cuando se transfiere un valor de la propiedad de destino para la propiedad de origen, el motor de enlace de datos quita primero cualquier ValidationError que es posible que haya agregado a la Validation.Errors adjunta la propiedad del elemento enlazado.When a value is being transferred from the target property to the source property, the data binding engine first removes any ValidationError that might have been added to the Validation.Errors attached property of the bound element. A continuación, comprueba si las reglas de validación personalizadas se definen para que Binding, en cuyo caso llama a la Validate método en cada ValidationRule pasar hasta que uno de ellos se produce un error o hasta que todos ellos.It then checks whether any custom validation rules are defined for that Binding, in which case it calls the Validate method on each ValidationRule until one of them fails or until all of them pass.

  2. Una vez que hay una regla personalizada que no pasa, el motor de enlace crea un ValidationError objeto y lo agrega a la Validation.Errors colección del elemento enlazado.Once there is a custom rule that does not pass, the binding engine creates a ValidationError object and adds it to the Validation.Errors collection of the bound element. Cuando Validation.Errors no está vacío, el Validation.HasError propiedad adjunta del elemento se establece en true.When Validation.Errors is not empty, the Validation.HasError attached property of the element is set to true. También, si la NotifyOnValidationError propiedad de la Binding está establecido en true, a continuación, el motor de enlace provoca el Validation.Error evento en el elemento adjunto.Also, if the NotifyOnValidationError property of the Binding is set to true, then the binding engine raises the Validation.Error attached event on the element.

  3. Si se superan todas las reglas, el motor de enlace, a continuación, llama al convertidor, si existe alguno.If all the rules pass, the binding engine then calls the converter, if one exists.

  4. Si pasa el convertidor, el motor de enlace llama al establecedor de la propiedad de origen.If the converter passes, the binding engine calls the setter of the source property.

  5. Si el enlace tiene una ExceptionValidationRule asociados con él y se produce una excepción durante el paso 3 o 4, el motor de enlace comprueba si hay un UpdateSourceExceptionFilter.If the binding has an ExceptionValidationRule associated with it and an exception is thrown during step 3 or 4, the binding engine checks to see if there is an UpdateSourceExceptionFilter. Puede usar el UpdateSourceExceptionFilter devolución de llamada para proporcionar un controlador personalizado para controlar las excepciones.You can use the UpdateSourceExceptionFilter callback to provide a custom handler for handling exceptions. Si un UpdateSourceExceptionFilter no se especifica en el Binding, el motor de enlace crea un ValidationError con la excepción y lo agrega a la Validation.Errors colección del elemento enlazado.If an UpdateSourceExceptionFilter is not specified on the Binding, the binding engine creates a ValidationError with the exception and adds it to the Validation.Errors collection of the bound element.

Una transferencia de valor válido en cualquier dirección (del destino al origen o del origen al destino), se borrará el Validation.Errors propiedad adjunta.A valid value transfer in either direction (target to source or source to target) will clear the Validation.Errors attached property.

Constructores

ValidationError(ValidationRule, Object) ValidationError(ValidationRule, Object) ValidationError(ValidationRule, Object) ValidationError(ValidationRule, Object)

Inicializa una nueva instancia de la clase ValidationError con los parámetros especificados.Initializes a new instance of the ValidationError class with the specified parameters.

ValidationError(ValidationRule, Object, Object, Exception) ValidationError(ValidationRule, Object, Object, Exception) ValidationError(ValidationRule, Object, Object, Exception) ValidationError(ValidationRule, Object, Object, Exception)

Inicializa una nueva instancia de la clase ValidationError con los parámetros especificados.Initializes a new instance of the ValidationError class with the specified parameters.

Propiedades

BindingInError BindingInError BindingInError BindingInError

Obtiene el objeto BindingExpression o MultiBindingExpression de este objeto ValidationError.Gets the BindingExpression or MultiBindingExpression object of this ValidationError. El objeto se marca explícitamente como no válido o tiene una regla de validación que ha generado un error.The object is either marked invalid explicitly or has a failed validation rule.

ErrorContent ErrorContent ErrorContent ErrorContent

Obtiene o establece un objeto que proporciona contexto adicional para esta clase ValidationError, como una cadena que describe el error.Gets or sets an object that provides additional context for this ValidationError, such as a string describing the error.

Exception Exception Exception Exception

Obtiene o establece el objeto Exception que fue la causa de este objeto ValidationError si el error es el resultado de una excepción.Gets or sets the Exception object that was the cause of this ValidationError, if the error is the result of an exception.

RuleInError RuleInError RuleInError RuleInError

Obtiene o establece el objeto ValidationRule que fue la causa de este objeto ValidationError si el error es el resultado de una regla de validación.Gets or sets the ValidationRule object that was the cause of this ValidationError, if the error is the result of a validation rule.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: