TypeValidationEventArgs.IsValidInput Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll
Origem:
TypeValidationEventArgs.cs
Origem:
TypeValidationEventArgs.cs
Origem:
TypeValidationEventArgs.cs
Origem:
TypeValidationEventArgs.cs
Origem:
TypeValidationEventArgs.cs

Recebe um valor que indica se a cadeia de entrada formatada foi convertida com sucesso para o tipo de validação.

public:
 property bool IsValidInput { bool get(); };
public bool IsValidInput { get; }
member this.IsValidInput : bool
Public ReadOnly Property IsValidInput As Boolean

Valor de Propriedade

Boolean

true se a cadeia de entrada formatada puder ser convertida no tipo especificado pela ValidatingType propriedade; caso contrário, false.

Exemplos

O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do MaskedTextBox.TypeValidationCompleted evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo MaskedTextBox chamada MaskedTextBox1. Depois, certifique-se de que o gestor de eventos está associado ao MaskedTextBox.TypeValidationCompleted evento.

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

Observações

A IsValidInput propriedade indica o sucesso do Parse método encontrado na Type representada pela ValidatingType propriedade. Este tipo deve conter Parse métodos(s) com uma ou ambas as seguintes assinaturas:

public static Object Parse(string)

public static Object Parse(string, IFormatProvider)

Parse é chamado antes do MaskedTextBox controlo levantar o TypeValidationCompleted evento. Este método é invocado com o conteúdo, menos os caracteres de prompt, da Text propriedade da MaskedTextBox classe. Se for bem-sucedido, devolve o objeto convertido; caso contrário, devolve null.

Para mais informações sobre o processo de validação de tipos, consulte o TypeValidationCompleted evento.

Aplica-se a

Ver também