BindingGroup.GetValue(Object, String) Metoda

Definicja

Zwraca proponowaną wartość dla określonej właściwości i elementu.

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

Parametry

item
Object

Obiekt zawierający określoną właściwość.

propertyName
String

Właściwość, której proponowana wartość ma być pobierana.

Zwraca

Object

Proponowana wartość właściwości.

Wyjątki

Nie ma powiązania dla określonego elementu i właściwości.

Wartość określonej właściwości jest niedostępna z powodu błędu konwersji lub wcześniejszej reguły walidacji nie powiodła się.

Przykłady

Poniższy przykład jest częścią aplikacji, która monituje użytkownika o wprowadzenie wielu klientów i przypisze przedstawicielowi ds. sprzedaży do każdego klienta. Aplikacja sprawdza, czy przedstawiciel handlowy i klient należą do tego samego regionu. W przykładzie przedstawiono metodę Validate , która używa GetValue(Object, String) metody do pobierania wartości wprowadzonych przez klienta.

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

Uwagi

Użyj tej metody w metodzie ValidationRule.Validate , aby uzyskać wartość, która ma zostać zatwierdzona w źródle. Typ wartości zwracanej zależy od etapu ValidationRule , na którym występuje. Jeśli na przykład dane TextBox są powiązane z właściwością typu liczba całkowita, a ValidationRule wywołania GetValue(Object, String) mają ustawioną ValidationStep RawProposedValuewartość , metoda zwraca ciąg. Jeśli właściwość ValidationRule ma ValidationStep ustawioną ConvertedProposedValuewartość , metoda zwraca dowolny typ zwracany przez konwerter powiązania. W tym przykładzie GetValue(Object, String) zwykle zwraca liczbę całkowitą.

Dotyczy