Op Englesch liesen Editéieren

Deelen iwwer


ArgumentNullException Constructors

Definition

Initializes a new instance of the ArgumentNullException class.

Overloads

ArgumentNullException()

Initializes a new instance of the ArgumentNullException class.

ArgumentNullException(String)

Initializes a new instance of the ArgumentNullException class with the name of the parameter that causes this exception.

ArgumentNullException(SerializationInfo, StreamingContext)
Obsolete.

Initializes a new instance of the ArgumentNullException class with serialized data.

ArgumentNullException(String, Exception)

Initializes a new instance of the ArgumentNullException class with a specified error message and the exception that is the cause of this exception.

ArgumentNullException(String, String)

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

ArgumentNullException()

Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs

Initializes a new instance of the ArgumentNullException class.

C#
public ArgumentNullException();

Remarks

This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "Value cannot be null." This message takes into account the current system culture.

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

Property Value
InnerException A null reference (Nothing in Visual Basic).
Message A localized error message string, such as "Value cannot be null." for the English language.

Applies to

.NET 10 an aner Versiounen
Produkt Versiounen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ArgumentNullException(String)

Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs

Initializes a new instance of the ArgumentNullException class with the name of the parameter that causes this exception.

C#
public ArgumentNullException(string paramName);
C#
public ArgumentNullException(string? paramName);

Parameters

paramName
String

The name of the parameter that caused the exception.

Remarks

This constructor initializes the Message property of the new instance to a system-supplied message that describes the error and includes the parameter name. This message takes into account the current system culture.

This constructor initializes the ParamName property of the new instance using the paramName parameter. The content of paramName is intended to be understood by humans.

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

Property Value
InnerException A null reference (Nothing in Visual Basic).
Message A localized error message string that identifies the null argument. For example, if the paramName argument is "arg1", the English language message string is:

On .NET 5+ and .NET Core: Value cannot be null. (Parameter name: 'arg1')

On .NET Framework: Value cannot be null.\r\nParameter name: arg1
ParamName The parameter name string.

Applies to

.NET 10 an aner Versiounen
Produkt Versiounen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ArgumentNullException(SerializationInfo, StreamingContext)

Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs

Caution

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Initializes a new instance of the ArgumentNullException class with serialized data.

C#
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ArgumentNullException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
C#
protected ArgumentNullException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
C#
[System.Security.SecurityCritical]
protected ArgumentNullException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

Parameters

info
SerializationInfo

The object that holds the serialized object data.

context
StreamingContext

An object that describes the source or destination of the serialized data.

Attributes

Remarks

This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see XML and SOAP Serialization.

See also

Applies to

.NET 10 an aner Versiounen
Produkt Versiounen (Obsolet)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 (8, 9, 10)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ArgumentNullException(String, Exception)

Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs

Initializes a new instance of the ArgumentNullException class with a specified error message and the exception that is the cause of this exception.

C#
public ArgumentNullException(string message, Exception innerException);
C#
public ArgumentNullException(string? message, Exception? innerException);

Parameters

message
String

The error message that explains the reason for this exception.

innerException
Exception

The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.

Applies to

.NET 10 an aner Versiounen
Produkt Versiounen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ArgumentNullException(String, String)

Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs
Source:
ArgumentNullException.cs

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

C#
public ArgumentNullException(string paramName, string message);
C#
public ArgumentNullException(string? paramName, string? message);

Parameters

paramName
String

The name of the parameter that caused the exception.

message
String

A message that describes the error.

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.

This constructor initializes the ParamName property of the new instance using the paramName parameter. The content of paramName is intended to be understood by humans.

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

Property Value
InnerException A null reference (Nothing in Visual Basic).
Message The error message string.
ParamName The parameter name string.

Applies to

.NET 10 an aner Versiounen
Produkt Versiounen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0