ArgumentException Sınıf

Tanım

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

Devralma

Object

Exception

ArgumentException

Devralma

Object

Exception

SystemException

ArgumentException

Türetilmiş

System.ArgumentNullException

System.ArgumentOutOfRangeException

System.ComponentModel.InvalidAsynchronousStateException

System.ComponentModel.InvalidEnumArgumentException

System.DuplicateWaitObjectException

Diğer…

Öznitelikler

SerializableAttribute ComVisibleAttribute

Uygulamalar

ISerializable

Örnekler

Aşağıdaki örnekte, oluşturma ve yakalama işlemleri gösterilmektedir ArgumentException. ArgumentException.GetType() kullanır. Özel durum nesnesinin adını görüntülemek için name özelliği ve ayrıca özel durum iletisinin metnini görüntülemek için özelliğini kullanırMessage.

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

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

Açıklamalar

ArgumentException bir yöntem çağrıldığında oluşturulur ve geçirilen bağımsız değişkenlerden en az biri çağrılan yöntemin parametre belirtimini karşılamaz. ParamName özelliği geçersiz bağımsız değişkeni tanımlar.

En yaygın olarak, ortak dil çalışma zamanı veya başka bir sınıf kitaplığı tarafından oluşturulur ArgumentException ve geliştirici hatasını gösterir. Kodunuzdan bir ArgumentException oluşturursanız, özel durumun Message özelliğinin geçersiz bağımsız değişkeni ve bağımsız değişken için beklenen değer aralığını açıklayan anlamlı bir hata iletisi içerdiğinden emin olmalısınız.

Birincil türetilmiş sınıfları ArgumentException ve ArgumentOutOfRangeException'dırArgumentNullException. Türetilmiş sınıfların hiçbirinin ArgumentExceptionkabul edilebilir olmadığı durumlar dışında, bu türetilmiş sınıflar yerine kullanılmalıdır. Örneğin, özel durumlar şu şekilde oluşturulmalıdır:

• ArgumentNullException geçerli bir bağımsız değişken olarak kabul etmeyen bir yönteme her null geçirildiğinde.

• ArgumentOutOfRangeException bağımsız değişkenin değeri kabul edilebilir değerler aralığının dışında olduğunda; örneğin, "46" değeri bir DateTimeoluşturulması sırasında ay bağımsız değişkeni olarak geçirildiğinde.

Yöntem çağrısında herhangi bir bağımsız değişken yoksa veya hata bağımsız değişkenlerin kendisini içermiyorsa kullanılmalıdır InvalidOperationException .

ArgumentException değeri 0x80070057 olan HRESULT COR_E_ARGUMENT kullanır.

örneğinin ilk özellik değerlerinin ArgumentExceptionlistesi için oluşturuculara ArgumentException bakın.

F# dilinde invalidArg işlevini kullanarak argumentException oluşturabilir ve oluşturabilirsiniz.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• Exception
• Özel Durumları İşleme ve Oluşturma