MaskedTextBox.MaskInputRejected MaskedTextBox.MaskInputRejected MaskedTextBox.MaskInputRejected MaskedTextBox.MaskInputRejected Event


ユーザーの入力または割り当てられた文字が、入力マスクの対応する書式要素と一致しない場合に発生します。Occurs when the user's input or assigned character does not match the corresponding format element of the input mask.

 event System::Windows::Forms::MaskInputRejectedEventHandler ^ MaskInputRejected;
public event System.Windows.Forms.MaskInputRejectedEventHandler MaskInputRejected;
member this.MaskInputRejected : System.Windows.Forms.MaskInputRejectedEventHandler 
Public Custom Event MaskInputRejected As MaskInputRejectedEventHandler 

次のコード例では、このメンバーの使用を示します。The following code example demonstrates the use of this member. 例では、イベント ハンドラーが発生するときに報告、MaskInputRejectedイベント。In the example, an event handler reports on the occurrence of the MaskInputRejected event. このレポートでは、イベントが発生してデバッグに役立つについて説明します。This report helps you to learn when the event occurs and can assist you in debugging. 複数のイベントまたは頻繁に発生するイベントを報告する、交換を検討MessageBox.ShowConsole.WriteLineまたはメッセージを複数行に追加TextBoxします。To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

コード例を実行する型のインスタンスを含むプロジェクトに貼り付けることMaskedTextBoxというMaskedTextBox1します。To run the example code, paste it into a project that contains an instance of type MaskedTextBox named MaskedTextBox1. イベント ハンドラーに関連付けられていることを確認し、MaskInputRejectedイベント。Then ensure that the event handler is associated with the MaskInputRejected event.

private void MaskedTextBox1_MaskInputRejected(Object sender, MaskInputRejectedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Position", e.Position );
messageBoxCS.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint );
MessageBox.Show(messageBoxCS.ToString(), "MaskInputRejected Event" );
Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) _ 
     Handles MaskedTextBox1.MaskInputRejected

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Position", e.Position)
    messageBoxVB.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint)
    MessageBox.Show(messageBoxVB.ToString(),"MaskInputRejected Event")

End Sub


MaskInputRejected 既定のイベントは、MaskedTextBoxクラス。MaskInputRejected is the default event for the MaskedTextBox class.

MaskInputRejectedイベントは、入力マスク文字が拒否された場合に発生します。The MaskInputRejected event occurs when a character is rejected by the input mask. によって表される、定型入力、Maskプロパティを使用してコントロールに関連付けられたマスクされたテキスト プロバイダーで解釈されます、MaskedTextProviderプロパティ。The input mask, represented by the Mask property, is interpreted by the masked text provider associated with the control through the MaskedTextProvider property. MaskInputRejected 次の状況で発生します。MaskInputRejected is raised in the following situations:

  • 入力文字が、対応する書式要素と一致しません。An input character does not match the corresponding format element. たとえば、ユーザーは、1 桁の数字が必要な場合、アルファベット文字を入力します。For example, the user enters an alphabetic character when a digit is required. このイベントが発生した理由の最も一般的な理由として考えられます。This is probably the most common reason why this event is raised.

  • ユーザーが、マスクの末尾を越える余分な文字を入力しようとして、マスクは既に入力されたか、現在のカレット位置が表示されている入力マスク文字列の末尾に移動されましたか。The user is trying to input extraneous characters beyond the end of the mask either because the mask has already been filled or the current caret position has been moved to the very end of the displayed input mask string.

  • 貼り付け操作はいずれかの形式が関連付けられている要素に一致しない文字を挿入する場合は、IsOverwriteModeプロパティはfalse、既存の文字を移動するときに、これらの要素の書式設定が一致しない新しい位置にします。A paste operation either inserts a character that does not match its associated format element, or if the IsOverwriteMode property is false, it shifts existing characters into new positions where they do not match their format elements.

  • 切り取り操作を左側の既存の文字のシフトして、1 つまたは複数の文字では、新しく関連付けられた書式要素が一致しません。A cut operation shifts existing characters to the left, and one or more characters do not match their newly associated format elements.

  • 割り当てが行われた、 Text 1 つまたは複数のマスク違反の原因となったプロパティと割り当てられている文字列。An assignment was made to the Text property and the assigned string caused one or more mask violations.

文字列が原因となるコントロールに割り当てられたかどうかMaskInputRejectedが発生する、文字列の一部は表示されませんMaskedTextBoxします。If a string was assigned to the control that causes MaskInputRejected to occur, no part of the string will appear in MaskedTextBox.

既定の処理をに対してMaskInputRejectedビープ音を鳴らすサウンドの場合に再生されます、BeepOnErrorプロパティに設定されてtrueします。The default handling for MaskInputRejected will play a beep sound if the BeepOnError property is set to true. このイベントが処理されるは、たとえば、カスタム エラー処理を実装するために、マスクがいっぱいで、次へ のユーザー入力コントロールに移動する、または入力文字が有効でない場合に、カスタム エラー ダイアログ ボックスまたはツールヒントを表示する多くの場合。This event is often handled to implement custom error handling, for example, to move to the next user input control if the mask is full, or to display a custom error dialog box or ToolTip if the input character is invalid.