ValidateValueCallback Delegat

Definition

Stellt eine Methode dar, die als Rückruf verwendet wird, mit dem der effektive Wert einer Abhängigkeitseigenschaft überprüft wird.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 

Parameter

value
Object

Der zu überprüfende Wert.The value to be validated.

Rückgabewert

Boolean

true, wenn der Wert überprüft wurde. false, wenn der übermittelte Wert ungültig war.true if the value was validated; false if the submitted value was invalid.

Vererbung
ValidateValueCallback

Beispiele

Das folgende Beispiel schließt eine Implementierung dieses Rückrufs ein, um einen Wertebereich für eine benutzerdefinierte Abhängigkeits Eigenschaft zu überprüfen.The following example includes an implementation of this callback to validate a range of values for a custom dependency property. In diesem Fall erwartet der Eigenschafts Wert eine Enumeration, und die Validierung stellt sicher, dass der bereitgestellte Wert zu einem Member dieser Enumeration ausgewertet wird.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

Hinweise

Rückrufe, die auf diesem Delegaten basieren, werden von DependencyProperty.Register bestimmten Signaturen von und verwandten Methoden RegisterAttached verwendet, z. b. und schreibgeschützte Entsprechungen.Callbacks based on this delegate are used by certain signatures of DependencyProperty.Register and related methods, such as RegisterAttached and read-only equivalents. Sie sollten Signaturen verwenden, die den validateValueCallback -Parameter verwenden, wenn Sie jedes Mal, wenn das effektive festgelegt ist, eine bestimmte Validierung des Eigenschafts Werts durchführen möchten.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. Anschließend sollten Sie diesen Rückruf so implementieren, dass die tatsächliche Validierung des vorgeschlagenen Werts durchführt.You should then implement this callback such that it performs the actual validation of the proposed value. Der Rückruf sollte zurück true geben false , wenn der an den Rückruf gesendete Wert gültig ist, andernfalls.The callback should return true if the value submitted to the callback is valid, and false otherwise. Ein false Wert erzeugt eine Ausnahme im spezifischen Teil des Eigenschaften Systems, in dem der ungültige Eigenschaften Satz versucht wurde, sodass Ihre Anwendung darauf vorbereitet sein sollte, diese Ausnahmen zu behandeln.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.

Validierungs Rückrufe werden anstelle von Metadaten für Abhängigkeits Eigenschaften in den Bezeichner von Abhängigkeits Eigenschaften gespeichert.Validation callbacks are stored on dependency property identifiers, rather than dependency property metadata. Der Validierungs Rückruf hat keinen Zugriff auf eine bestimmte Instanz von DependencyObject , auf der die-Eigenschaft festgelegt ist, und kann nur beeinflussen, welche Werte für die-Eigenschaft im Allgemeinen akzeptiert werden.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. Wenn Sie einen Rückruf benötigen, der Eigenschaftswerte basierend auf einer bestimmten Instanz ändern kann, sollten Sie eine Kombination CoerceValueCallback aus PropertyChangedCallback einem-und einem-Rückrufe verwenden, die auf die Eigenschafts Metadaten der Eigenschaft angewendet werden.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. Sie können diese Rückrufe auch auf verwandte Eigenschaften anwenden, die den Wert der Eigenschaft beeinflussen sollten.You might also apply these callbacks to related properties that should influence your property's value. Weitere Informationen finden Sie unter Rückrufe und Validierung von Abhängigkeits Eigenschaften.For details, see Dependency Property Callbacks and Validation.

Erweiterungsmethoden

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.Gets an object that represents the method represented by the specified delegate.

Gilt für:

Siehe auch