BindingGroup.TryGetValue(Object, String, Object) Método

Definição

Tenta obter o valor proposto para a propriedade e o item especificados.

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

Parâmetros

item
Object

O objeto que contém a propriedade especificada.

propertyName
String

A propriedade cujo valor proposto é adquirir.

value
Object

Quando este método retorna, contém um objeto que representa o valor proposto da propriedade. Este parâmetro é passado sem inicializar.

Devoluções

true se o valor for o valor proposto para a propriedade especificada; caso contrário, false.

Exemplos

O exemplo seguinte cria um custom ValidationRule chamado ValidateDateAndPrice. No Validate método, o exemplo utiliza o TryGetValue método e a Items propriedade para obter os valores inseridos pelo utilizador no formulário. Depois, o exemplo verifica que, se um artigo tiver mais de 100 dólares, estará disponível pelo menos sete dias. Este exemplo faz parte de um exemplo maior sobre a BindingGroup classe

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

Observações

TryGetValue retornos false se não houver uma ligação para o item e propriedade especificados ou se o valor da propriedade especificada não estiver disponível, devido a um erro de conversão ou porque uma regra de validação anterior falhou.

Use este método no ValidationRule.Validate método para obter o valor a comprometer com a fonte. O tipo value depende da fase em que ocorre ValidationRule . Por exemplo, se um TextBox é um dado ligado a uma propriedade de tipo inteiro, value é uma cadeia se o ValidationRule que chama TryGetValue tem o seu ValidationStep conjunto como RawProposedValue. Se o ValidationRule tiver definido ValidationStep como ConvertedProposedValue, o tipo de value é o tipo que é devolvido pelo conversor da ligação. Neste exemplo, value é geralmente um inteiro.

Aplica-se a