InvalidEnumArgumentException Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.dll

Die Ausnahme, die ausgelöst wird, wenn ein ungültiger Enumerationswert verwendet wird.

public ref class InvalidEnumArgumentException : ArgumentException

[System.Serializable]
public class InvalidEnumArgumentException : ArgumentException

[<System.Serializable>]
type InvalidEnumArgumentException = class
    inherit ArgumentException

Public Class InvalidEnumArgumentException
Inherits ArgumentException

Vererbung

Object

Exception

SystemException

ArgumentException

InvalidEnumArgumentException

Attribute

SerializableAttribute

Beispiele

Das folgende Codebeispiel zeigt, wie eine InvalidEnumArgumentException Ausnahme erfasst und deren Inhalt interpretiert wird. Im Beispiel wird versucht, einen ungültigen Enumerationswert (MessageBoxButtons) durch Umwandlung als drittes Argument der MessageBox.Show Methode zu übergeben. Beim Abfangen der Ausnahme ruft das Beispiel die entsprechende Fehlermeldung, den ungültigen Parameter, die Stapelüberwachung und den Ursprung der Ausnahme ab.

try
{
   //Attempting to pass an invalid enum value (MessageBoxButtons) to the Show method
   MessageBoxButtons myButton = (MessageBoxButtons)123; // to fix use System::Windows::Forms::DialogResult::OK;

   MessageBox::Show( this,  "This is a message",  "This is the Caption", myButton );
}
catch ( InvalidEnumArgumentException^ invE ) 
{
   Console::WriteLine( invE->Message );
   Console::WriteLine( invE->ParamName );
   Console::WriteLine( invE->StackTrace );
   Console::WriteLine( invE->Source );
}

try
{
    // Attempts to pass an invalid enum value (MessageBoxButtons) to the Show method
    MessageBoxButtons myButton = (MessageBoxButtons)123;
    MessageBox.Show("This is a message", "This is the Caption", myButton);
}
catch (InvalidEnumArgumentException invE)
{
    Console.WriteLine(invE.Message);
    Console.WriteLine(invE.ParamName);
    Console.WriteLine(invE.StackTrace);
    Console.WriteLine(invE.Source);
}

Try
    ' Attempts to pass an invalid enum value (MessageBoxButtons) to the Show method
    Dim myButton As MessageBoxButtons
    myButton = CType(123, MessageBoxButtons)
    MessageBox.Show("This is a message", "This is the Caption", myButton)
Catch invE As System.ComponentModel.InvalidEnumArgumentException
    Console.WriteLine(invE.Message)
    Console.WriteLine(invE.ParamName)
    Console.WriteLine(invE.StackTrace)
    Console.WriteLine(invE.Source)
End Try

Hinweise

Diese Ausnahme wird ausgelöst, wenn Sie einen ungültigen Enumerationswert an eine Methode oder beim Festlegen einer Eigenschaft übergeben.

Konstruktoren

Name	Beschreibung
InvalidEnumArgumentException()	Initialisiert eine neue Instanz der InvalidEnumArgumentException Klasse ohne Nachricht.
InvalidEnumArgumentException(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der Klasse mithilfe der InvalidEnumArgumentException angegebenen Serialisierungsdaten und des angegebenen Kontexts.
InvalidEnumArgumentException(String, Exception)	Initialisiert eine neue Instanz der InvalidEnumArgumentException Klasse mit der angegebenen detaillierten Beschreibung und der angegebenen Ausnahme.
InvalidEnumArgumentException(String, Int32, Type)	Initialisiert eine neue Instanz der InvalidEnumArgumentException Klasse mit einer aus dem Argument generierten Nachricht, dem ungültigen Wert und einer Enumerationsklasse.
InvalidEnumArgumentException(String)	Initialisiert eine neue Instanz der InvalidEnumArgumentException Klasse mit der angegebenen Nachricht.

Eigenschaften

Name	Beschreibung
Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
HelpLink	Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist. (Geerbt von Exception)
HResult	Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist. (Geerbt von Exception)
InnerException	Ruft die Exception Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
Message	Ruft die Fehlermeldung und den Parameternamen oder nur die Fehlermeldung ab, wenn kein Parametername festgelegt ist. (Geerbt von ArgumentException)
ParamName	Ruft den Namen des Parameters ab, der diese Ausnahme verursacht. (Geerbt von ArgumentException)
Source	Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception Ursache einer oder mehrerer nachfolgenden Ausnahmen zurückgegeben. (Geerbt von Exception)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Legt das SerializationInfo Objekt mit dem Parameternamen und zusätzliche Ausnahmeinformationen fest. (Geerbt von ArgumentException)
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Erstellt und gibt eine Zeichenfolgendarstellung der aktuellen Ausnahme zurück. (Geerbt von Exception)

Ereignisse

Name	Beschreibung
SerializeObjectState	Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält. (Geerbt von Exception)