ArgumentException Класс

Определение

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

Наследование

Object

Exception

ArgumentException

Наследование

Object

Exception

SystemException

ArgumentException

Производный

System.ArgumentNullException

System.ArgumentOutOfRangeException

System.ComponentModel.InvalidAsynchronousStateException

System.ComponentModel.InvalidEnumArgumentException

System.DuplicateWaitObjectException

Подробнее…

Атрибуты

SerializableAttribute ComVisibleAttribute

Реализации

ISerializable

Примеры

В следующем примере показано, как вызывать и перехватывать ArgumentExceptionобъект. В нем используется АргументException.GetType(). Свойство Name для отображения имени объекта исключения, а также использует Message свойство для отображения текста сообщения об исключении.

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

Комментарии

ArgumentException вызывается при вызове метода, и хотя бы один из переданных аргументов не соответствует спецификации параметра вызываемого метода. Свойство ParamName определяет недопустимый аргумент.

Чаще всего ArgumentException вызывается средой cl language runtime или другой библиотекой классов и указывает на ошибку разработчика. Если вы создаете код ArgumentException , необходимо убедиться, что свойство исключения Message содержит понятное сообщение об ошибке, описывающее недопустимый аргумент и ожидаемый диапазон значений для аргумента.

Основными производными классами ArgumentException являются ArgumentNullException и ArgumentOutOfRangeException. Эти производные классы следует использовать вместо ArgumentExceptionних, за исключением ситуаций, когда ни из производных классов не допускается. Например, исключения должны создаваться следующим образом:

• ArgumentNullException каждый раз, когда null передается методу, который не принимает его в качестве допустимого аргумента.

• ArgumentOutOfRangeException если значение аргумента находится вне диапазона допустимых значений; Например, если значение "46" передается в качестве аргумента месяца во время создания DateTimeобъекта.

Если вызов метода не имеет никаких аргументов или если сбой не включает сами аргументы, InvalidOperationException то следует использовать.

ArgumentException использует COR_E_ARGUMENT HRESULT, которая имеет значение 0x80070057.

Список начальных значений свойств для экземпляра ArgumentExceptionсм. в конструкторах ArgumentException.

В F#можно использовать недопустимую функциюArg для создания и создания аргументаException.

См. также раздел

• Exception
• Обработка и создание исключений