BindingGroup.GetValue(Object, String) メソッド

定義

指定されているプロパティと項目に対して提示されている値を返します。

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

パラメーター

item
Object

指定されているプロパティを含むオブジェクト。

propertyName
String

提示されている値を取得するプロパティ。

戻り値

Object

提示されているプロパティ値。

例外

指定されている項目とプロパティにはバインディングがありません。

変換エラーまたは前の検証ルールが失敗したために、指定されているプロパティの値は使用できません。

次の例は、複数の顧客を入力し、各顧客に営業担当者を割り当てるようユーザーに求めるアプリケーションの一部です。 アプリケーションは、営業担当者と顧客が同じリージョンに属していることを確認します。 この例では、メソッドを Validate 使用して顧客が GetValue(Object, String) 入力した値を取得するメソッドを示します。

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

注釈

ソースにコミットする値を ValidationRule.Validate 取得するには、メソッドでこのメソッドを使用します。 戻り値の型は、発生する ValidationRule ステージによって異なります。 たとえば、a TextBox が整数型のプロパティにバインドされ、その呼び出しGetValue(Object, String)ValidationRuleの値が設定RawProposedValueされている場合、メソッドはValidationStep文字列を返します。 ValidationRuleValidationStep設定ConvertedProposedValueされている場合、メソッドはバインディングのコンバーターによって返される任意の型を返します。 この例では、通常は GetValue(Object, String) 整数を返します。

適用対象