MaskedTextBox.RejectInputOnFirstFailure 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

첫 번째 잘못된 문자에 도달하면 사용자 입력의 구문 분석을 중지해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.

public:
 property bool RejectInputOnFirstFailure { bool get(); void set(bool value); };

public bool RejectInputOnFirstFailure { get; set; }

member this.RejectInputOnFirstFailure : bool with get, set

Public Property RejectInputOnFirstFailure As Boolean

속성 값

Boolean

첫 번째 구문 분석 오류에서 입력 문자열 처리를 종료하면 true이고, 모든 오류를 무시하고 처리하면 false입니다. 기본값은 false입니다.

설명

경우에 따라 사용자는 일반적으로 문자열을 복사하여 붙여넣어 단일 입력 작업에서 에 여러 문자를 MaskedTextBox 입력합니다. 입력 마스크의 붙여넣기 위치에 따라 전체 문자열에 유효한 문자만 포함된 경우 전체 작업이 성공합니다. 그러나 구문 분석 오류가 발생하면 의 MaskedTextBox 동작은 다음과 같이 의 RejectInputOnFirstFailure값에 따라 달라집니다.

• 이 속성이 이 true면 입력 문자열의 처리가 잘못된 문자에서 중지됩니다. 모든 후속 문자는 무시됩니다. 단일 MaskInputRejected 이벤트가 발생합니다.

• 이 속성이 이 false면 잘못된 문자가 거부되지만 구문 분석이 입력 문자열의 다음 문자로 계속됩니다. 입력 문자열의 MaskInputRejected 모든 잘못된 문자에 대해 이벤트가 발생합니다.

, ResetOnSpace 및 SkipLiterals 속성은 ResetOnPrompt사용자 입력의 해석에도 영향을 줄 수 있습니다.

속성이 false이 IsOverwriteMode 면 삽입 지점 오른쪽에 있는 입력 마스크에 이미 있는 모든 문자가 허용되는 문자 수만큼 변위됩니다. 이러한 이동으로 인해 추가 구문 분석 오류가 발생할 수 있습니다.

붙여넣기 작업은 속성을 설정 SelectedText 하여 프로그래밍 방식으로 모방할 수 있습니다.

추가 정보

• Mask
• MaskInputRejected
• ResetOnPrompt
• ResetOnSpace
• IsOverwriteMode
• SelectedText