BindingGroup.GetValue(Object, String) Método

Definição

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.

Aplica-se a