ArgumentException Constructor (String, String)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Initializes a new instance of the ArgumentException class with a specified error message and the name of the parameter that causes this exception.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub New ( _
    message As String, _
    paramName As String _
)
public ArgumentException(
    string message,
    string paramName
)

Parameters

  • message
    Type: System.String
    The error message that explains the reason for the exception.
  • paramName
    Type: System.String
    The name of the parameter that caused the current exception.

Remarks

This constructor initializes the Message property of the new instance using the value of the message parameter. The content of the message parameter is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.

The following table shows the initial property values for an instance of ArgumentException.

Property

Value

Message

The error message string.

Examples

The following code example demonstrates how to call the ArgumentException constructor. This code example is part of a larger example provided for the ArgumentException class.

static int DivideByTwo(int num)
{
   // If num is an odd number, throw an ArgumentException.
   if ((num & 1) == 1)
      throw new ArgumentException("Number must be even", "num");

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.