ValidateValueCallback Délégué

Définition

Représente une méthode utilisée comme un rappel qui valide la valeur effective d’une propriété de dépendance.Represents a method used as a callback that validates the effective value of a dependency property.

public delegate bool ValidateValueCallback(System::Object ^ value);
public delegate bool ValidateValueCallback(object value);
type ValidateValueCallback = delegate of obj -> bool
Public Delegate Function ValidateValueCallback(value As Object) As Boolean 

Paramètres

value
Object

Valeur à valider.The value to be validated.

Valeur renvoyée

Boolean

true si la valeur a été validée ; false si la valeur soumise n'était pas valide.true if the value was validated; false if the submitted value was invalid.

Héritage
ValidateValueCallback

Exemples

L’exemple suivant comprend une implémentation de ce rappel pour valider une plage de valeurs pour une propriété de dépendance personnalisée.The following example includes an implementation of this callback to validate a range of values for a custom dependency property. Dans ce cas, la valeur de la propriété attend une énumération, et la validation s’assure que la valeur fournie correspond à un membre de cette énumération.In this case the property value expects an enumeration, and the validation assures that the provided value evaluates to a member of that enumeration.

private static bool ShirtValidateCallback(object value)
{
    ShirtTypes sh = (ShirtTypes) value;
    return (sh==ShirtTypes.None || sh == ShirtTypes.Bowling || sh == ShirtTypes.Dress || sh == ShirtTypes.Rugby || sh == ShirtTypes.Tee);

}
Private Shared Function ShirtValidateCallback(ByVal value As Object) As Boolean
    Dim sh As ShirtTypes = CType(value, ShirtTypes)
    Return (sh=ShirtTypes.None OrElse sh = ShirtTypes.Bowling OrElse sh = ShirtTypes.Dress OrElse sh = ShirtTypes.Rugby OrElse sh = ShirtTypes.Tee)

End Function

Remarques

Les rappels basés sur ce délégué sont utilisés par certaines signatures DependencyProperty.Register de et les méthodes associées, RegisterAttached telles que et les équivalents en lecture seule.Callbacks based on this delegate are used by certain signatures of DependencyProperty.Register and related methods, such as RegisterAttached and read-only equivalents. Vous devez utiliser des signatures qui prennent validateValueCallback le paramètre si vous souhaitez une validation spécifique de la valeur de propriété chaque fois que son effectif est défini.You should use signatures that take the validateValueCallback parameter if you want specific validation of the property value each time that its effective is set. Vous devez ensuite implémenter ce rappel de façon à ce qu’il effectue la validation réelle de la valeur proposée.You should then implement this callback such that it performs the actual validation of the proposed value. Le rappel doit retourner true si la valeur envoyée au rappel est valide; false sinon,.The callback should return true if the value submitted to the callback is valid, and false otherwise. Une false valeur produira une exception dans la partie spécifique du système de propriétés dans laquelle le jeu de propriétés non valides a été tenté, de sorte que votre application doit être préparée à gérer ces exceptions.A false value will produce an exception in the specific portion of the property system where the invalid property set was attempted, so your application should be prepared to handle these exceptions.

Les rappels de validation sont stockés sur les identificateurs de propriété de dépendance, plutôt que sur les métadonnées de propriété de dépendance.Validation callbacks are stored on dependency property identifiers, rather than dependency property metadata. Votre rappel de validation n’a pas accès à une instance spécifique d' DependencyObject un sur lequel la propriété est définie, et peut influencer uniquement les valeurs qui sont acceptées pour la propriété en général.Your validation callback does not have access to a specific instance of a DependencyObject on which the property is set, and can only influence what values are accepted for the property in general. Si vous avez besoin d’un rappel qui peut modifier des valeurs de propriété en fonction d’une instance spécifique, vous devez CoerceValueCallback utiliser PropertyChangedCallback une combinaison de rappels et comme appliqué aux métadonnées de propriété de votre propriété.If you need a callback that can change property values based on a specific instance, you should use a combination of a CoerceValueCallback and PropertyChangedCallback callbacks as applied to the property metadata of your property. Vous pouvez également appliquer ces rappels aux propriétés associées qui doivent influencer la valeur de votre propriété.You might also apply these callbacks to related properties that should influence your property's value. Pour plus d’informations, consultez validation et rappels de propriétés de dépendance.For details, see Dependency Property Callbacks and Validation.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.Gets an object that represents the method represented by the specified delegate.

S’applique à

Voir aussi