BindingGroup.TryGetValue(Object, String, Object) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.