InvalidEnumArgumentException Klasa

Definicja

Wyjątek zgłoszony w przypadku używania nieprawidłowych argumentów, które są modułami wyliczanymi.The exception thrown when using invalid arguments that are enumerators.

public ref class InvalidEnumArgumentException : ArgumentException
public class InvalidEnumArgumentException : ArgumentException
[System.Serializable]
public class InvalidEnumArgumentException : ArgumentException
type InvalidEnumArgumentException = class
    inherit ArgumentException
Public Class InvalidEnumArgumentException
Inherits ArgumentException
Dziedziczenie
InvalidEnumArgumentException
Atrybuty

Przykłady

Poniższy przykład kodu pokazuje, jak przechwytywać InvalidEnumArgumentException wyjątek i interpretować jego zawartość.The following code example shows how to catch an InvalidEnumArgumentException exception and interpret its content. Przykład próbuje przekazać nieprawidłową wartość wyliczenia (MessageBoxButtons) przez rzutowanie jako trzeci argument metody MessageBox.Show.The example attempts to pass an invalid enumeration value (MessageBoxButtons) through casting, as the MessageBox.Show method's third argument. Po przechwyceniu wyjątku przykład pobiera odpowiedni komunikat o błędzie, nieprawidłowy parametr, ślad stosu i początkową wyjątek.Upon catching the exception, the example fetches the respective error message, the invalid parameter, stack trace, and origin of the exception.

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.This exception is thrown if you pass an invalid enumeration value to a method or when setting a property.

Konstruktory

InvalidEnumArgumentException()

Inicjuje nowe wystąpienie klasy InvalidEnumArgumentException bez komunikatu.Initializes a new instance of the InvalidEnumArgumentException class without a message.

InvalidEnumArgumentException(SerializationInfo, StreamingContext)

Inicjuje nowe wystąpienie klasy InvalidEnumArgumentException przy użyciu określonych danych serializacji i kontekstu.Initializes a new instance of the InvalidEnumArgumentException class using the specified serialization data and context.

InvalidEnumArgumentException(String)

Inicjuje nowe wystąpienie klasy InvalidEnumArgumentException z określonym komunikatem.Initializes a new instance of the InvalidEnumArgumentException class with the specified message.

InvalidEnumArgumentException(String, Exception)

Inicjuje nowe wystąpienie klasy InvalidEnumArgumentException z określonym szczegółowym opisem i określonym wyjątkem.Initializes a new instance of the InvalidEnumArgumentException class with the specified detailed description and the specified exception.

InvalidEnumArgumentException(String, Int32, Type)

Inicjuje nowe wystąpienie klasy InvalidEnumArgumentException z komunikatem wygenerowanym z argumentu, nieprawidłowej wartości i klasy wyliczenia.Initializes a new instance of the InvalidEnumArgumentException class with a message generated from the argument, the invalid value, and an enumeration class.

Właściwości

Data

Pobiera kolekcję par klucz/wartość, które zawierają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Odziedziczone po Exception)
HelpLink

Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem.Gets or sets a link to the help file associated with this exception.

(Odziedziczone po Exception)
HResult

Pobiera lub ustawia wartość HRESULT, kodowane wartości liczbowe przypisane do określonego wyjątku.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Odziedziczone po Exception)
InnerException

Pobiera wystąpienie Exception, które spowodowało wyjątek bieżący.Gets the Exception instance that caused the current exception.

(Odziedziczone po Exception)
Message

Pobiera komunikat o błędzie i nazwę parametru lub tylko komunikat o błędzie, jeśli nie ustawiono nazwy parametru.Gets the error message and the parameter name, or only the error message if no parameter name is set.

(Odziedziczone po ArgumentException)
ParamName

Pobiera nazwę parametru powodującego ten wyjątek.Gets the name of the parameter that causes this exception.

(Odziedziczone po ArgumentException)
Source

Pobiera lub ustawia nazwę aplikacji lub obiekt, który powoduje błąd.Gets or sets the name of the application or the object that causes the error.

(Odziedziczone po Exception)
StackTrace

Pobiera ciąg reprezentujący bezpośrednie ramki w stosie wywołań.Gets a string representation of the immediate frames on the call stack.

(Odziedziczone po Exception)
TargetSite

Pobiera metodę, która zgłasza bieżący wyjątek.Gets the method that throws the current exception.

(Odziedziczone po Exception)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetBaseException()

Gdy jest zastępowany w klasie pochodnej, zwraca Exception, który jest główną przyczyną jednego lub kilku kolejnych wyjątków.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Odziedziczone po Exception)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)

Ustawia obiekt SerializationInfo z nazwą parametru i dodatkowymi informacjami o wyjątku.Sets the SerializationInfo object with the parameter name and additional exception information.

(Odziedziczone po ArgumentException)
GetType()

Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia.Gets the runtime type of the current instance.

(Odziedziczone po Exception)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.Creates and returns a string representation of the current exception.

(Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Odziedziczone po Exception)

Dotyczy