ArgumentException Klasse

Definition

public ref class ArgumentException : Exception

public ref class ArgumentException : SystemException

public class ArgumentException : Exception

public class ArgumentException : SystemException

[System.Serializable]
public class ArgumentException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentException : SystemException

type ArgumentException = class
    inherit Exception

type ArgumentException = class
    inherit SystemException

type ArgumentException = class
    inherit SystemException
    interface ISerializable

[<System.Serializable>]
type ArgumentException = class
    inherit SystemException
    interface ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentException = class
    inherit SystemException
    interface ISerializable

Public Class ArgumentException
Inherits Exception

Public Class ArgumentException
Inherits SystemException

Vererbung

Object

Exception

ArgumentException

Vererbung

Object

Exception

SystemException

ArgumentException

Abgeleitet

System.ArgumentNullException

System.ArgumentOutOfRangeException

System.ComponentModel.InvalidAsynchronousStateException

System.ComponentModel.InvalidEnumArgumentException

System.DuplicateWaitObjectException

Mehr …

Attribute

SerializableAttribute ComVisibleAttribute

Implementiert

ISerializable

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine ausgelöst und abfangen ArgumentException wird. Es wird ArgumentException.GetType() verwendet. Name-Eigenschaft, um den Namen des Ausnahmeobjekts anzuzeigen, und verwendet auch die Message -Eigenschaft, um den Text der Ausnahmemeldung anzuzeigen.

using namespace System;

static int DivideByTwo(int num) 
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
        throw gcnew ArgumentException(String::Format("{0} is not an even number", num), 
                                      "num");

    // num is even, return half of its value.
    return num / 2;
}

void main() 
{
    // Define some integers for a division operation.
    array<int>^ values = { 10, 7 };
    for each (int value in values) {
        try {
           Console::WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value));
        }
        catch (ArgumentException^ e) {
           Console::WriteLine("{0}: {1}", e->GetType()->Name, e->Message);
        }
        Console::WriteLine();
    }
}
// This example displays the following output:
//     10 divided by 2 is 5
//     
//     ArgumentException: 7 is not an even number
//     Parameter name: num

using System;

public class Example
{
    static void Main()
    {
        // Define some integers for a division operation.
        int[] values = { 10, 7 };
        foreach (var value in values) {
            try {
               Console.WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value));
            }
            catch (ArgumentException e) {
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message);
            }
            Console.WriteLine();
        }
    }

    static int DivideByTwo(int num)
    {
        // If num is an odd number, throw an ArgumentException.
        if ((num & 1) == 1)
            throw new ArgumentException(String.Format("{0} is not an even number", num),
                                      "num");

        // num is even, return half of its value.
        return num / 2;
    }
}
// This example displays the following output:
//     10 divided by 2 is 5
//
//     ArgumentException: 7 is not an even number
//     Parameter name: num

Public Class Example
    Public Shared Sub Main()
        ' Define some integers for a division operation.
        Dim values() As Integer = { 10, 7 }

        For Each value In values
            Try 
               Console.WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value))
            Catch e As ArgumentException
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message)
            End Try
            Console.WriteLine()
        Next
    End Sub
    
    Private Shared Function DivideByTwo(ByVal num As Integer) As Integer
        ' If num is an odd number, throw an ArgumentException.
        If (num And 1) = 1 Then
            Throw New ArgumentException(String.Format("{0} is not an even number", num), 
                                      "num")
        End If
        Return num \ 2
    End Function
End Class
' The example displays the following output:
'     10 divided by 2 is 5
'     
'     ArgumentException: 7 is not an even number
'     Parameter name: num

Hinweise

ArgumentException wird ausgelöst, wenn eine Methode aufgerufen wird und mindestens eines der übergebenen Argumente nicht der Parameterspezifikation der aufgerufenen Methode entspricht. Die ParamName -Eigenschaft identifiziert das ungültige Argument.

Am häufigsten ArgumentException wird ein von der Common Language Runtime oder einer anderen Klassenbibliothek ausgelöst und weist auf einen Entwicklerfehler hin. Wenn Sie ArgumentException eine von Ihrem Code auslösen, sollten Sie sicherstellen, dass die -Eigenschaft der Ausnahme Message eine aussagekräftige Fehlermeldung enthält, die das ungültige Argument und den erwarteten Wertebereich für das Argument beschreibt.

Die primären abgeleiteten Klassen von ArgumentException sind ArgumentNullException und ArgumentOutOfRangeException . Diese abgeleiteten Klassen sollten anstelle von verwendet werden, ArgumentException außer in Situationen, in denen keine der abgeleiteten Klassen akzeptabel ist. Ausnahmen sollten beispielsweise durch Folgendes ausgelöst werden:

• ArgumentNullException wird immer null dann an eine Methode übergeben, die sie nicht als gültiges Argument akzeptiert.

• ArgumentOutOfRangeException , wenn der Wert eines Arguments außerhalb des Bereichs zulässiger Werte liegt; Beispielsweise, wenn der Wert "46" während der Erstellung eines als Month-Argument übergeben DateTime wird.

Wenn der Methodenaufruf über kein Argument verfügt oder der Fehler nicht die Argumente selbst einbezieht, InvalidOperationException sollte verwendet werden.

ArgumentException verwendet die HRESULT-COR_E_ARGUMENT, die den Wert 0x80070057 hat.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von ArgumentException, finden Sie unter den ArgumentException Konstruktoren.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für

Siehe auch

• Exception
• Behandeln und Auslösen von Ausnahmen