BindingGroup.TryGetValue(Object, String, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 será obtido.
- value
- Object
Quando este método retornar, conterá um objeto que representa o valor da propriedade proposto. Este parâmetro é passado não inicializado.
Retornos
true
se o valor for o valor proposto para a propriedade especificada; caso contrário, false
.
Exemplos
O exemplo a seguir cria um nome ValidateDateAndPrice
personalizadoValidationRule. Validate No método, o exemplo usa o TryGetValue método e a Items propriedade para obter os valores que o usuário inseriu no formulário. Em seguida, o exemplo verifica se um item tem mais de 100 dólares, ele ficará disponível por pelo menos sete dias. Este exemplo faz parte de um exemplo maior na 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
Comentários
TryGetValue retornará false
se não houver uma associação para o item e a 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 esse método no ValidationRule.Validate método para obter o valor a ser confirmado na origem. O tipo value
depende do estágio em que ocorre ValidationRule . Por exemplo, se os TextBox dados estiverem associados a uma propriedade do tipo inteiro, value
será uma cadeia de caracteres se as ValidationRule chamadas TryGetValue tiverem seu ValidationStep conjunto definido como RawProposedValue. Se o ValidationRule conjunto for ValidationStep definido como ConvertedProposedValue, o tipo de value
é qualquer tipo retornado pelo conversor da associação. Neste exemplo, value
geralmente é um inteiro.