MaskedTextProvider.VerifyChar メソッド

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

MaskedTextProvider.VerifyChar メソッド

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

指定した文字を指定した位置に正常に設定できるかどうかをテストします。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function VerifyChar ( _
    input As Char, _
    position As Integer, _
    <OutAttribute> ByRef hint As MaskedTextResultHint
 _
) As Boolean

Visual Basic (使用法)

Dim instance As MaskedTextProvider
Dim input As Char
Dim position As Integer
Dim hint As MaskedTextResultHint
Dim returnValue As Boolean

returnValue = instance.VerifyChar(input, position, hint)

C#

public bool VerifyChar (
    char input,
    int position,
    out MaskedTextResultHint hint
)

C++

public:
bool VerifyChar (
    wchar_t input, 
    int position, 
    [OutAttribute] MaskedTextResultHint% hint
)

J#

public boolean VerifyChar (
    char input, 
    int position, 
    /** @attribute OutAttribute() */ /** @ref */ MaskedTextResultHint hint
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

input

テスト対象の Char 値。

position

入力文字をテストするマスク内の位置。

hint

操作の結果を簡潔に示す MaskedTextResultHint。出力パラメータ。

戻り値
指定した文字が指定した位置に対して有効な場合は true。それ以外の場合は false。

解説

VerifyChar メソッドは、単一の文字値が、書式設定された文字列内の指定した位置にある有効な入力を表しているかどうかをテストします。次の条件が当てはまる場合、このメソッドは false を返します。

• pos パラメータが 0 未満か、Mask の Length よりも大きい値である場合。

• 文字 input が、IsValidInputChar メソッドによって判断された有効な入力文字ではない場合。

• input に pos で指定した位置にあるマスク要素との互換性がない場合。

最後の条件は、AllowPromptAsInput、AsciiOnly、PasswordChar、PromptChar および SkipLiterals の各プロパティの現在の値によって異なる場合があります。

マスクに対して入力文字列全体をテストするには、このメソッドではなく VerifyString メソッドのいずれかを使用します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
MaskedTextProvider クラス
MaskedTextProvider メンバ
System.ComponentModel 名前空間
IsValidInputChar
Mask
IsEditPosition
VerifyEscapeChar
VerifyString