ConvertTextToValue メソッド

ValueToTextConverterResolved を使用して、指定したテキストを値タイプに変換します。このメソッドは一般的にユーザーによって修正されたテキストを ValueType に変換するために呼び出されます。

シンタックス

Visual Basic

'宣言
 
Public Function ConvertTextToValue( _
   ByVal text As String, _
   ByRef value As Object, _
   ByRef error As Exception _
) As Boolean

C#

public bool ConvertTextToValue( 
   string text,
   out object value,
   out Exception error
)

パラメータ

text

変換するテキスト。

value

この出力パラメーターは、変換された値に設定されます。

error

変換が失敗すると、エラーはエラーを示す値に設定されます。

戻り値の型

変換が成功すれば True、そうでなければ False。

解説

ConvertTextToValue は、ValueType プロパティに指定されたオブジェクト タイプにテキストを変換するのに使用されます。このメソッドは一般的に Value プロパティから返される値にテキストでユーザー入力を変換します。Value プロパティは、ValueType プロパティによって指定されたタイプのオブジェクトを返します。

たとえば、XamMaskedInput の ValueType プロパティが DateTime タイプに設定されていて、ユーザーが「1/1/07」を入力した場合、このメソッドはテキスト値を DateTime オブジェクトに変換するために呼び出されます。

注： 一般的にこのメソッドを直接呼び出す必要はありません。このメソッドは、テキストと値の間の必要な変換を実行するために ValueInput 自身によって自動的に呼び出されるからです。

注: テキストと値の間の変換にデフォルト変換ロジックをオーバーライドしたい場合、ValueToTextConverter および ValueToDisplayTextConverter プロパティを設定します。