MaskedTextBox.ValidateText メソッド

.NET Framework クラス ライブラリ リファレンス

MaskedTextBox.ValidateText メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザー入力文字列を、検証する型のインスタンスに変換します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function ValidateText As
 Object

Visual Basic (使用法)

Dim instance As MaskedTextBox
Dim returnValue As Object

returnValue = instance.ValidateText

C#

public Object ValidateText ()

C++

public:
Object^ ValidateText ()

J#

public Object ValidateText ()

JScript

public function ValidateText () : Object

戻り値
成功した場合は、ValidatingType プロパティで指定された型の Object。それ以外の場合は、変換が失敗したことを示す null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
Exception	入力文字列の解析中に、重大な例外が発生しました。

解説

ValidateText メソッドは、Text プロパティに含まれる書式設定された文字列を、ValidatingType プロパティで指定された型のインスタンスに変換しようとします。書式設定された文字列ではプロンプト文字は無視されますが、リテラルは、TextMaskFormat プロパティの現在の値に従って処理されます。

変換が試行された後、変換が成功したかどうかに関係なく、ValidateText は TypeValidationCompleted イベントを発生させます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MaskedTextBox クラス
MaskedTextBox メンバ
System.Windows.Forms 名前空間
Text
ValidatingType
TypeValidationCompleted
TextMaskFormat