MaskedTextBox.ValidateText MaskedTextBox.ValidateText MaskedTextBox.ValidateText MaskedTextBox.ValidateText Method

定義

ユーザー入力文字列を、検証する型のインスタンスに変換します。Converts the user input string to an instance of the validating type.

public:
 System::Object ^ ValidateText();
public object ValidateText ();
member this.ValidateText : unit -> obj
Public Function ValidateText () As Object

戻り値

成功した場合は、Object プロパティで指定された型の ValidatingType。それ以外の場合は、変換が失敗したことを示す nullIf successful, an Object of the type specified by the ValidatingType property; otherwise, null to indicate conversion failure.

例外

入力文字列の解析中に、重大な例外が発生しました。A critical exception occurred during the parsing of the input string.

注釈

メソッドValidateTextは、プロパティTextに格納されている書式設定された文字列を、 ValidatingTypeプロパティで指定された型のインスタンスに変換しようとします。The ValidateText method attempts to convert the formatted string contained in the Text property to an instance of the type that is specified by the ValidatingType property. 書式設定された文字列では、プロンプト文字は無視されますが、リテラルはTextMaskFormatプロパティの現在の値に従って処理されます。Prompt characters are ignored in the formatted string, but literals are handled in accordance with the current value of the TextMaskFormat property.

ValidateText成功しTypeValidationCompletedたかどうかに関係なく、変換の試行後にイベントを発生させます。ValidateText raises the TypeValidationCompleted event after the conversion is attempted, regardless of its success.

適用対象

こちらもご覧ください