ArgumentException Klass

Definition

public ref class ArgumentException : Exception

public ref class ArgumentException : SystemException

public class ArgumentException : Exception

[System.Serializable]
public class ArgumentException : SystemException

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

public class ArgumentException : SystemException

type ArgumentException = class
    inherit Exception

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

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

type ArgumentException = class
    inherit SystemException
    interface ISerializable

type ArgumentException = class
    inherit SystemException

Public Class ArgumentException
Inherits Exception

Public Class ArgumentException
Inherits SystemException

Arv

Object

Exception

ArgumentException

Arv

Object

Exception

SystemException

ArgumentException

Härledda

System.ArgumentNullException

System.ArgumentOutOfRangeException

System.ComponentModel.InvalidAsynchronousStateException

System.ComponentModel.InvalidEnumArgumentException

System.DuplicateWaitObjectException

Mer…

Attribut

SerializableAttribute ComVisibleAttribute

Implementeringar

ISerializable

Exempel

I följande exempel visas hur du genererar och fångar en ArgumentException. Den använder ArgumentException.GetType(). Namnegenskap för att visa namnet på undantagsobjektet och använder Message även egenskapen för att visa texten i undantagsmeddelandet.

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

open System

let divideByTwo num =
    // If num is an odd number, throw an ArgumentException.
    if num % 2 = 1 then
        invalidArg "num" $"{num} is not an even number"

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

// Define some integers for a division operation.
let values = [ 10; 7 ]
for value in values do
    try 
        printfn $"{value} divided by 2 is {divideByTwo value}"
    with
    | :? ArgumentException as e ->
        printfn $"{e.GetType().Name}: {e.Message}"
    
    printfn ""

// This example displays the following output:
//     10 divided by 2 is 5
//
//     ArgumentException: 7 is not an even number (Parameter '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

Kommentarer

ArgumentException genereras när en metod anropas och minst ett av de skickade argumenten inte uppfyller parameterspecifikationen för den anropade metoden. Egenskapen ParamName identifierar det ogiltiga argumentet.

Oftast genereras en ArgumentException av den vanliga språkkörningen eller ett annat klassbibliotek och anger utvecklarfel. Om du genererar en ArgumentException från koden bör du se till att undantagets Message egenskap innehåller ett meningsfullt felmeddelande som beskriver det ogiltiga argumentet och det förväntade värdeintervallet för argumentet.

De primära härledda klasserna ArgumentException för är ArgumentNullException och ArgumentOutOfRangeException. Dessa härledda klasser bör användas i stället för ArgumentException, förutom i situationer där ingen av de härledda klasserna är acceptabel. Undantag bör till exempel genereras av:

• ArgumentNullException när null skickas till en metod som inte accepterar den som ett giltigt argument.

• ArgumentOutOfRangeException när värdet för ett argument ligger utanför intervallet för acceptabla värden. Till exempel när värdet "46" skickas som månadsargument när en DateTime.

Om metodanropet inte har något argument eller om felet inte omfattar själva argumenten ska det InvalidOperationException användas.

ArgumentException använder HRESULT-COR_E_ARGUMENT, som har värdet 0x80070057.

För en lista över inledande egenskapsvärden för en instans av ArgumentException, se i ArgumentException-konstruktorn.

I F#kan du använda funktionen invalidArg för att generera och skapa ett ArgumentException.

Se även

• Exception
• Hantera och utlösa undantag