MaskedTextBox.MaskInputRejected Evento

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Si verifica quando l'input dell'utente o il carattere assegnato non corrisponde al rispettivo elemento di formattazione della maschera di input.

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 

Tipo evento

MaskInputRejectedEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento MaskInputRejected . Questo report consente di apprendere quando si verifica l'evento e può essere utile per eseguire il debug. Per segnalare più eventi o eventi che si verificano spesso, è consigliabile sostituire MessageBox.Show con Console.WriteLine o aggiungere il messaggio a una multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo MaskedTextBox denominata MaskedTextBox1. Assicurarsi quindi che il gestore eventi sia associato all'evento MaskInputRejected .

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

Commenti

MaskInputRejected è l'evento predefinito per la MaskedTextBox classe.

L'evento MaskInputRejected si verifica quando un carattere viene rifiutato dalla maschera di input. La maschera di input, rappresentata dalla proprietà, viene interpretata dal Mask provider di testo mascherato associato al controllo tramite la MaskedTextProvider proprietà . MaskInputRejected viene generato nelle situazioni seguenti:

• Un carattere di input non corrisponde all'elemento di formato corrispondente. Ad esempio, l'utente immette un carattere alfabetico quando è necessaria una cifra. Questo è probabilmente il motivo più comune per cui questo evento viene generato.

• L'utente sta tentando di inserire caratteri extranei oltre la fine della maschera perché la maschera è già stata riempita o la posizione corrente del caret è stata spostata alla fine della stringa maschera di input visualizzata.

• Un'operazione incolla inserisce un carattere che non corrisponde al relativo elemento di formato associato oppure se la IsOverwriteMode proprietà è false, sposta i caratteri esistenti in nuove posizioni in cui non corrispondono ai relativi elementi di formato.

• Un'operazione di taglio sposta i caratteri esistenti a sinistra e uno o più caratteri non corrispondono agli elementi di formato appena associati.

• Un'assegnazione è stata effettuata alla Text proprietà e la stringa assegnata ha causato una o più violazioni della maschera.

Se una stringa è stata assegnata al controllo che causa MaskInputRejected l'esecuzione, nessuna parte della stringa verrà visualizzata in MaskedTextBox.

La gestione predefinita per MaskInputRejected eseguirà un suono di beep se la BeepOnError proprietà è impostata su true. Questo evento viene spesso gestito per implementare la gestione degli errori personalizzata, ad esempio per passare al controllo di input utente successivo se la maschera è completa o per visualizzare una finestra di dialogo di errore personalizzata o Descrizione comando se il carattere di input non è valido.

Vedi anche

• Text
• Mask
• MaskedTextProvider
• MaskInputRejectedEventArgs
• IsOverwriteMode
• BeepOnError