BindingGroup.TryGetValue(Object, String, Object) Methode

Definition

Versucht, den vorgeschlagenen Wert für die angegebene Eigenschaft und das Element abzurufen.Attempts to get the proposed value for the specified property and item.

public:
 bool TryGetValue(System::Object ^ item, System::String ^ propertyName, [Runtime::InteropServices::Out] System::Object ^ % value);
public bool TryGetValue (object item, string propertyName, out object value);
member this.TryGetValue : obj * string * obj -> bool
Public Function TryGetValue (item As Object, propertyName As String, ByRef value As Object) As Boolean

Parameter

item
Object

Das Objekt, das die angegebene Eigenschaft enthält.The object that contains the specified property.

propertyName
String

Die Eigenschaft, deren vorgeschlagener Wert abgerufen werden soll.The property whose proposed value to get.

value
Object

Enthält nach dem Beenden dieser Methode ein Objekt, das den vorgeschlagenen Eigenschaftswert darstellt.When this method returns, contains an object that represents the proposed property value. Dieser Parameter wird nicht initialisiert übergeben.This parameter is passed uninitialized.

Gibt zurück

Boolean

true, wenn der Wert der vorgeschlagene Wert für die angegebene Eigenschaft ist, andernfalls false.true if value is the proposed value for the specified property; otherwise, false.

Beispiele

Im folgenden Beispiel wird ein benutzerdefinierter mit dem ValidationRule Namen erstellt ValidateDateAndPrice .The following example creates a custom ValidationRule named ValidateDateAndPrice. In der Validate -Methode verwendet das Beispiel die TryGetValue -Methode und die- Items Eigenschaft, um die Werte zu erhalten, die der Benutzer in das Formular eingegeben hat.In the Validate method, the example uses the TryGetValue method and the Items property to get the values the user entered into the form. Im Beispiel wird überprüft, ob ein Element, das mehr als 100 Dollar beträgt, mindestens sieben Tage lang verfügbar ist.Then the example checks that if an item is over 100 dollars, it will be available for at least seven days. Dieses Beispiel ist Teil eines größeren Beispiels für die- BindingGroup Klasse.This example is part of a larger example on the BindingGroup class

public class ValidateDateAndPrice : ValidationRule
{
    // Ensure that an item over $100 is available for at least 7 days.
    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
    {
        BindingGroup bg = value as BindingGroup;

        // Get the source object.
        PurchaseItem item = bg.Items[0] as PurchaseItem;
        
        object doubleValue;
        object dateTimeValue;

        // Get the proposed values for Price and OfferExpires.
        bool priceResult = bg.TryGetValue(item, "Price", out doubleValue);
        bool dateResult = bg.TryGetValue(item, "OfferExpires", out dateTimeValue);

        if (!priceResult || !dateResult)
        {
            return new ValidationResult(false, "Properties not found");
        }

        double price = (double)doubleValue;
        DateTime offerExpires = (DateTime)dateTimeValue;

        // Check that an item over $100 is available for at least 7 days.
        if (price > 100)
        {
            if (offerExpires < DateTime.Today + new TimeSpan(7, 0, 0, 0))
            {
                return new ValidationResult(false, "Items over $100 must be available for at least 7 days.");
            }
        }

        return ValidationResult.ValidResult;
    }
}
Public Class ValidateDateAndPrice
    Inherits ValidationRule
    ' Ensure that an item over $100 is available for at least 7 days.
    Public Overrides Function Validate(ByVal value As Object, ByVal cultureInfo As CultureInfo) As ValidationResult
        Dim bg As BindingGroup = TryCast(value, BindingGroup)

        ' Get the source object.
        Dim item As PurchaseItem = TryCast(bg.Items(0), PurchaseItem)

        Dim doubleValue As Object = Nothing
        Dim dateTimeValue As Object = Nothing

        ' Get the proposed values for Price and OfferExpires.
        Dim priceResult As Boolean = bg.TryGetValue(item, "Price", doubleValue)
        Dim dateResult As Boolean = bg.TryGetValue(item, "OfferExpires", dateTimeValue)

        If (Not priceResult) OrElse (Not dateResult) Then
            Return New ValidationResult(False, "Properties not found")
        End If

        Dim price As Double = CDbl(doubleValue)
        Dim offerExpires As Date = CDate(dateTimeValue)

        ' Check that an item over $100 is available for at least 7 days.
        If price > 100 Then
            If offerExpires < Date.Today + New TimeSpan(7, 0, 0, 0) Then
                Return New ValidationResult(False, "Items over $100 must be available for at least 7 days.")
            End If
        End If

        Return ValidationResult.ValidResult

    End Function
End Class

Hinweise

TryGetValue Gibt zurück false , wenn keine Bindung für das angegebene Element und die angegebene Eigenschaft vorhanden ist, oder, wenn der Wert der angegebenen Eigenschaft aufgrund eines Konvertierungs Fehlers oder aufgrund eines Fehlers bei einer früheren Validierungs Regel nicht verfügbar ist.TryGetValue returns false if there is not a binding for the specified item and property or if the value of the specified property is not available, due to a conversion error or because an earlier validation rule failed.

Verwenden Sie diese Methode in der- ValidationRule.Validate Methode, um den Wert zu erhalten, der an die Quelle übertragen werden soll.Use this method in the ValidationRule.Validate method to get the value to be committed to the source. Der Typ value hängt von der Stufe ab, in der die ValidationRule auftritt.The type value depends on the stage at which the ValidationRule occurs. Wenn z. b TextBox . eine Datenbindung an eine Eigenschaft vom Typ Integer ist, value ist eine Zeichenfolge, wenn die ValidationRule , die aufruft, TryGetValue ValidationStep auf festgelegt ist RawProposedValue .For example, if a TextBox is data bound to a property of type integer, value is a string if the ValidationRule that calls TryGetValue has its ValidationStep set to RawProposedValue. Wenn der ValidationRule ValidationStep auf festgelegt ist ConvertedProposedValue , ist der Typ von der Typ, der value vom Konverter der Bindung zurückgegeben wird.If the ValidationRule has its ValidationStep set to ConvertedProposedValue, the type of value is whatever type that is returned by the binding's converter. In diesem Beispiel value ist in der Regel eine ganze Zahl.In this example, value is usually an integer.

Gilt für: