TypeValidationEventArgs.Cancel 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

TypeValidationEventArgs.cs

이벤트를 취소해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.

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

public bool Cancel { get; set; }

member this.Cancel : bool with get, set

Public Property Cancel As Boolean

속성 값

Boolean

이벤트를 취소하고 컨트롤에서 포커스를 유지해야 하면 />이고, 그렇지 않으면 유효성 검사 처리를 계속합니다.

예제

다음 코드 예제에서는이 멤버의 사용을 보여 줍니다. 이 예제에서 이벤트 처리기는 이벤트의 발생을 보고합니다 MaskedTextBox.TypeValidationCompleted . 이 보고서는 이벤트가 발생하는 시기를 파악하는 데 도움이 되며 디버깅에 도움이 될 수 있습니다. 여러 이벤트 또는 자주 발생하는 이벤트에 대해 보고하려면 메시지를 여러 줄MessageBox.Show로 Console.WriteLine 대체 TextBox 하거나 추가해 보세요.

예제 코드를 실행하려면 이름이 지정된 MaskedTextBox형식 MaskedTextBox1 의 인스턴스가 포함된 프로젝트에 붙여넣습니다. 그런 다음 이벤트 처리기가 이벤트와 연결되어 있는지 확인합니다 MaskedTextBox.TypeValidationCompleted .

private void MaskedTextBox1_TypeValidationCompleted(Object sender, TypeValidationEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "IsValidInput", e.IsValidInput );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Message", e.Message );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ValidatingType", e.ValidatingType );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "TypeValidationCompleted Event" );
}

Private Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs) _ 
     Handles MaskedTextBox1.TypeValidationCompleted

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "IsValidInput", e.IsValidInput)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Message", e.Message)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ValidatingType", e.ValidatingType)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"TypeValidationCompleted Event")

End Sub

설명

이벤트는 TypeValidationCompleted 이벤트 바로 전에 Validating 발생합니다.

Cancel 이벤트 처리기에서 TypeValidationCompleted 속성을 true 설정하면 이벤트가 취소되어 MaskedTextBox 후속 Validating 이벤트가 속성의 버전을 설정하지 않는 한 컨트롤이 포커스를 CancelEventArgs.Cancel 유지합니다false.

추가 정보

• TypeValidationCompleted
• Validating