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.

public:
 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.Show 사용 하 여 Console.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.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint );
messageBoxCS.AppendLine();
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.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint)
    messageBoxVB.AppendLine()
    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. 예를 들어 사용자가 숫자가 필요한 경우 영문자를 입력 합니다.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.

  • 잘라내기 작업 기존 문자를 왼쪽으로 이동 하 고 하나 이상의 문자에 해당 새로 연결 된 형식이 요소 일치 하지 않습니다.A cut operation shifts existing characters to the left, and one or more characters do not match their newly associated format elements.

  • 할당 하려고 합니다 Text 속성 및 할당 된 문자열에는 하나 이상의 마스크 위반 발생 했습니다.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.

적용 대상

추가 정보