InvalidEnumArgumentException Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.dll

Wyjątek zgłaszany, gdy jest używana nieprawidłowa wartość wyliczenia.

public ref class InvalidEnumArgumentException : ArgumentException

[System.Serializable]
public class InvalidEnumArgumentException : ArgumentException

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

Public Class InvalidEnumArgumentException
Inherits ArgumentException

Dziedziczenie

Object

Exception

SystemException

ArgumentException

InvalidEnumArgumentException

Atrybuty

SerializableAttribute

Przykłady

Poniższy przykład kodu pokazuje, jak przechwycić InvalidEnumArgumentException wyjątek i interpretować jego zawartość. Przykład próbuje przekazać nieprawidłową wartość wyliczenia (MessageBoxButtons) przez rzutowanie jako MessageBox.Show trzeci argument metody. Po przechwyceniu wyjątku przykład pobiera odpowiedni komunikat o błędzie, nieprawidłowy parametr, ślad stosu i źródło wyjątku.

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

Uwagi

Ten wyjątek jest zgłaszany w przypadku przekazania nieprawidłowej wartości wyliczenia do metody lub podczas ustawiania właściwości.

Konstruktory

Nazwa	Opis
InvalidEnumArgumentException()	Inicjuje nowe wystąpienie InvalidEnumArgumentException klasy bez komunikatu.
InvalidEnumArgumentException(SerializationInfo, StreamingContext)	Inicjuje nowe wystąpienie InvalidEnumArgumentException klasy przy użyciu określonych danych serializacji i kontekstu.
InvalidEnumArgumentException(String, Exception)	Inicjuje nowe wystąpienie InvalidEnumArgumentException klasy z określonym szczegółowym opisem i określonym wyjątkiem.
InvalidEnumArgumentException(String, Int32, Type)	Inicjuje nowe wystąpienie InvalidEnumArgumentException klasy z komunikatem wygenerowanym na podstawie argumentu, nieprawidłową wartością i klasą wyliczenia.
InvalidEnumArgumentException(String)	Inicjuje nowe wystąpienie InvalidEnumArgumentException klasy z określonym komunikatem.

Właściwości

Nazwa	Opis
Data	Pobiera kolekcję par klucz/wartość, które zapewniają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku. (Odziedziczone po Exception)
HelpLink	Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem. (Odziedziczone po Exception)
HResult	Pobiera lub ustawia HRESULT, zakodowaną wartość liczbową przypisaną do określonego wyjątku. (Odziedziczone po Exception)
InnerException	Exception Pobiera wystąpienie, które spowodowało bieżący wyjątek. (Odziedziczone po Exception)
Message	Pobiera komunikat o błędzie i nazwę parametru lub tylko komunikat o błędzie, jeśli nie ustawiono nazwy parametru. (Odziedziczone po ArgumentException)
ParamName	Pobiera nazwę parametru, który powoduje ten wyjątek. (Odziedziczone po ArgumentException)
Source	Pobiera lub ustawia nazwę aplikacji lub obiektu, który powoduje błąd. (Odziedziczone po Exception)
StackTrace	Pobiera reprezentację ciągu natychmiastowych ramek na stosie wywołań. (Odziedziczone po Exception)
TargetSite	Pobiera metodę, która zgłasza bieżący wyjątek. (Odziedziczone po Exception)

Metody

Nazwa	Opis
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBaseException()	Po zastąpieniu w klasie pochodnej funkcja zwraca Exception główną przyczynę co najmniej jednego kolejnego wyjątku. (Odziedziczone po Exception)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo Ustawia obiekt z nazwą parametru i dodatkowymi informacjami o wyjątku. (Odziedziczone po ArgumentException)
GetType()	Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia. (Odziedziczone po Exception)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception)

Zdarzenia

Nazwa	Opis
SerializeObjectState	Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane dotyczące wyjątku. (Odziedziczone po Exception)