InvalidEnumArgumentException-Klasse

Die bei Verwendung ungültiger Enumeratorargumente ausgelöste Ausnahme.

Namespace: System.ComponentModel
Assembly: System (in system.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public Class InvalidEnumArgumentException
    Inherits ArgumentException
'Usage
Dim instance As InvalidEnumArgumentException

[SerializableAttribute] 
public class InvalidEnumArgumentException : ArgumentException

[SerializableAttribute] 
public ref class InvalidEnumArgumentException : public ArgumentException

/** @attribute SerializableAttribute() */ 
public class InvalidEnumArgumentException extends ArgumentException

SerializableAttribute 
public class InvalidEnumArgumentException extends ArgumentException

Hinweise

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

Hinweis

Das auf diese Klasse angewendete HostProtectionAttribute-Attribut besitzt den Resources-Eigenschaftenwert SharedState. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder eines URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie eine InvalidEnumArgumentException-Ausnahme abgefangen 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 wird im Beispiel die entsprechende Fehlermeldung, der ungültige Parameter, die Stapelüberwachung und der Ursprung der Ausnahme abgerufen.

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

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
{
   //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.get_Message());
    Console.WriteLine(invE.get_ParamName());
    Console.WriteLine(invE.get_StackTrace());
    Console.WriteLine(invE.get_Source());
}

Vererbungshierarchie

System.Object
   System.Exception
     System.SystemException
       System.ArgumentException
        System.ComponentModel.InvalidEnumArgumentException

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

InvalidEnumArgumentException-Member
System.ComponentModel-Namespace