MaskedTextBox.MaskInputRejected Ereignis

Definition

Tritt ein, wenn die Eingabe oder das zugewiesene Zeichen nicht mit dem entsprechenden Formatelement der Eingabemaske übereinstimmt.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 

Ereignistyp

MaskInputRejectedEventHandler

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht.The following code example demonstrates the use of this member. Im Beispiel meldet ein Ereignishandler das Vorkommen des MaskInputRejected Ereignisses.In the example, an event handler reports on the occurrence of the MaskInputRejected event. Mit diesem Bericht können Sie lernen, wann das Ereignis auftritt und Sie beim Debuggen unterstützen können.This report helps you to learn when the event occurs and can assist you in debugging. Wenn Sie mehrere Ereignisse oder Ereignisse, die häufig auftreten, melden möchten, empfiehlt es sich, durch zu ersetzen MessageBox.Show Console.WriteLine oder die Nachricht an eine mehrzeilige anfügen 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.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz des Typs mit dem MaskedTextBox Namen enthält MaskedTextBox1 .To run the example code, paste it into a project that contains an instance of type MaskedTextBox named MaskedTextBox1. Stellen Sie dann sicher, dass der Ereignishandler dem MaskInputRejected Ereignis zugeordnet ist.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

Hinweise

MaskInputRejected ist das Standard Ereignis für die- MaskedTextBox Klasse.MaskInputRejected is the default event for the MaskedTextBox class.

Das MaskInputRejected Ereignis tritt auf, wenn ein Zeichen von der Eingabemaske abgelehnt wird.The MaskInputRejected event occurs when a character is rejected by the input mask. Die durch die-Eigenschaft dargestellte Eingabemaske Mask wird von dem maskierten Text Anbieter interpretiert, der dem-Steuerelement über die-Eigenschaft zugeordnet ist 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 wird in den folgenden Situationen ausgelöst:MaskInputRejected is raised in the following situations:

  • Ein Eingabezeichen stimmt nicht mit dem entsprechenden Format Element überein.An input character does not match the corresponding format element. Der Benutzer gibt z. b. ein alphabetisches Zeichen ein, wenn eine Ziffer erforderlich ist.For example, the user enters an alphabetic character when a digit is required. Dies ist wahrscheinlich der häufigste Grund, warum dieses Ereignis ausgelöst wird.This is probably the most common reason why this event is raised.

  • Der Benutzer versucht, über das Ende der Maske hinausgehende Zeichen einzugeben, entweder weil die Maske bereits ausgefüllt wurde oder die aktuelle Position der Einfügemarke an das Ende der angezeigten Eingabemasken Zeichenfolge verschoben wurde.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.

  • Bei einem Einfügevorgang wird entweder ein Zeichen eingefügt, das nicht mit dem zugehörigen Format Element identisch ist, oder wenn die- IsOverwriteMode Eigenschaft ist false , werden vorhandene Zeichen in neue Positionen verschoben, wo Sie nicht mit ihren Format Elementen identisch sind.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.

  • Ein Ausschneide Vorgang verschiebt vorhandene Zeichen nach links, und ein oder mehrere Zeichen stimmen nicht mit den neu zugeordneten Format Elementen identisch.A cut operation shifts existing characters to the left, and one or more characters do not match their newly associated format elements.

  • An der Eigenschaft wurde eine Zuweisung vorgenommen, Text und die zugewiesene Zeichenfolge verursachte mindestens einen Masken Verstoß.An assignment was made to the Text property and the assigned string caused one or more mask violations.

Wenn dem Steuerelement, das auslöst, eine Zeichenfolge zugewiesen wurde MaskInputRejected , wird in kein Teil der Zeichenfolge angezeigt MaskedTextBox .If a string was assigned to the control that causes MaskInputRejected to occur, no part of the string will appear in MaskedTextBox.

Die Standardbehandlung für MaskInputRejected gibt einen Signal Sound wieder, wenn die- BeepOnError Eigenschaft auf festgelegt ist true .The default handling for MaskInputRejected will play a beep sound if the BeepOnError property is set to true. Dieses Ereignis wird häufig behandelt, um benutzerdefinierte Fehlerbehandlung zu implementieren, z. b. um zum nächsten Benutzereingabe-Steuerelement zu wechseln, wenn die Maske voll ist, oder um ein benutzerdefiniertes Fehler Dialogfeld oder eine QuickInfo anzuzeigen, wenn das Eingabezeichen ungültig ist.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.

Gilt für:

Siehe auch