BindingGroup.GetValue(Object, String) 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.
Devolve o valor proposto para a propriedade e o item especificados.
public:
System::Object ^ GetValue(System::Object ^ item, System::String ^ propertyName);
public object GetValue(object item, string propertyName);
override this.GetValue : obj * string -> obj
Public Function GetValue (item As Object, propertyName As String) As Object
Parâmetros
- item
- Object
O objeto que contém a propriedade especificada.
- propertyName
- String
A propriedade cujo valor proposto é adquirir.
Devoluções
O valor proposto da propriedade.
Exceções
Não existe uma vinculação para o item e propriedade especificados.
O valor da propriedade especificada não está disponível, devido a um erro de conversão ou porque uma regra de validação anterior falhou.
Exemplos
O exemplo seguinte faz parte de uma aplicação que pede ao utilizador para introduzir vários clientes e atribuir um representante de vendas a cada cliente. A aplicação verifica se o representante de vendas e o cliente pertencem à mesma região. O exemplo mostra o Validate método, que utiliza o GetValue(Object, String) método para obter valores que o cliente inseriu.
public class AreasMatch : ValidationRule
{
public override ValidationResult Validate(object value, System.Globalization.CultureInfo cultureInfo)
{
BindingGroup bg = value as BindingGroup;
Customer cust = bg.Items[0] as Customer;
if (cust == null)
{
return new ValidationResult(false, "Customer is not the source object");
}
Region region = (Region)bg.GetValue(cust, "Location");
ServiceRep rep = bg.GetValue(cust, "ServiceRepresentative") as ServiceRep;
string customerName = bg.GetValue(cust, "Name") as string;
if (region == rep.Area)
{
return ValidationResult.ValidResult;
}
else
{
StringBuilder sb = new StringBuilder();
sb.AppendFormat("{0} must be assigned a sales representative that serves the {1} region. \n ", customerName, region);
return new ValidationResult(false, sb.ToString());
}
}
}
Public Class AreasMatch
Inherits ValidationRule
Public Overrides Function Validate(ByVal value As Object, ByVal cultureInfo As System.Globalization.CultureInfo) As ValidationResult
Dim bg As BindingGroup = TryCast(value, BindingGroup)
Dim cust As Customer = TryCast(bg.Items(0), Customer)
If cust Is Nothing Then
Return New ValidationResult(False, "Customer is not the source object")
End If
Dim region As Region = CType(bg.GetValue(cust, "Location"), Region)
Dim rep As ServiceRep = TryCast(bg.GetValue(cust, "ServiceRepresentative"), ServiceRep)
Dim customerName As String = TryCast(bg.GetValue(cust, "Name"), String)
If region = rep.Area Then
Return ValidationResult.ValidResult
Else
Dim sb As New StringBuilder()
sb.AppendFormat("{0} must be assigned a sales representative that serves the {1} region. " & vbLf & " ", customerName, region)
Return New ValidationResult(False, sb.ToString())
End If
End Function
End Class
Observações
Use este método no ValidationRule.Validate método para obter o valor a comprometer com a fonte. O tipo do valor de retorno depende da fase em que ocorre ValidationRule . Por exemplo, se um TextBox é um dado ligado a uma propriedade de tipo inteiro e o ValidationRule que chama GetValue(Object, String) tem o seu ValidationStep conjunto como RawProposedValue, o método devolve uma cadeia. Se o ValidationRule tiver definido ValidationStep como ConvertedProposedValue, o método devolve o tipo que é devolvido pelo conversor da ligação. Neste exemplo, GetValue(Object, String) normalmente devolve um inteiro.