TypeValidationEventArgs Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

TypeValidationEventArgs.cs

Stellt Daten für das TypeValidationCompleted-Ereignis bereit.

public ref class TypeValidationEventArgs : EventArgs

public class TypeValidationEventArgs : EventArgs

type TypeValidationEventArgs = class
    inherit EventArgs

Public Class TypeValidationEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

TypeValidationEventArgs

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des TypeValidationCompleted Ereignisses. Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis auftritt und Sie beim Debuggen unterstützen kann. Wenn Sie über mehrere Ereignisse oder ereignisse berichten möchten, die häufig auftreten, erwägen Sie, die Nachricht durch Show eine mehrteilige Console.WriteLineNachricht zu ersetzen TextBox oder sie anzufügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz des Typs MaskedTextBox namens MaskedTextBox1enthält. Stellen Sie dann sicher, dass der Ereignishandler dem TypeValidationCompleted Ereignis zugeordnet ist.

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

Hinweise

Das TypeValidationCompleted Ereignis tritt auf, wenn ein Steuerelement eine MaskedTextBox optionale Typüberprüfung durchführt. Die Typüberprüfung erfolgt nur, wenn die MaskedTextBox.ValidatingType Eigenschaft nicht null erfolgt und eine kausale Aktion auftritt, z. B. das Steuerelement, das den MaskedTextBox Fokus verliert. Die Typüberprüfung ist die Möglichkeit, die formatierte Eingabezeichenfolge in den durch die ValidatingType Eigenschaft dargestellten Typ zu konvertieren. Weitere Informationen zum Typüberprüfungsprozess finden Sie im TypeValidationCompleted Ereignis.

Wenn ein Ereignishandler für TypeValidationCompletedden Fall implementiert ist, empfängt der Handler einen Parameter vom Typ TypeValidationEventArgs. Dieser Parameter enthält Informationen zum Ereignis, z. B. ob der Typkonvertierungsprozess erfolgreich war, der Überprüfungstyp usw.

Konstruktoren

Name	Beschreibung
TypeValidationEventArgs(Type, Boolean, Object, String)	Initialisiert eine neue Instanz der TypeValidationEventArgs-Klasse.

Eigenschaften

Name	Beschreibung
Cancel	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Ereignis abgebrochen werden soll.
IsValidInput	Ruft einen Wert ab, der angibt, ob die formatierte Eingabezeichenfolge erfolgreich in den Überprüfungstyp konvertiert wurde.
Message	Ruft eine Textnachricht ab, die den Konvertierungsprozess beschreibt.
ReturnValue	Ruft das Objekt ab, das aus der Konvertierung der formatierten Eingabezeichenfolge resultiert.
ValidatingType	Ruft den Typ ab, für den die formatierte Eingabezeichenfolge überprüft wird.

Weitere Informationen

• ValidatingType
• ValidateText()
• TypeValidationCompleted
• Exemplarische Vorgehensweise: Arbeiten mit dem MaskedTextBox-Steuerelement