Ask Learn
Preview
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign inNullReferenceException Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the NullReferenceException class.
Overloads
| NullReferenceException() |
Initializes a new instance of the NullReferenceException class, setting the Message property of the new instance to a system-supplied message that describes the error, such as "The value 'null' was found where an instance of an object was required." This message takes into account the current system culture. |
| NullReferenceException(String) |
Initializes a new instance of the NullReferenceException class with a specified error message. |
| NullReferenceException(SerializationInfo, StreamingContext) |
Obsolete.
Initializes a new instance of the NullReferenceException class with serialized data. |
| NullReferenceException(String, Exception) |
Initializes a new instance of the NullReferenceException class with a specified error message and a reference to the inner exception that is the cause of this exception. |
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
Initializes a new instance of the NullReferenceException class, setting the Message property of the new instance to a system-supplied message that describes the error, such as "The value 'null' was found where an instance of an object was required." This message takes into account the current system culture.
public:
NullReferenceException();C#
public NullReferenceException();Public Sub New ()Remarks
The following table shows the initial property values for an instance of NullReferenceException.
| Property | Value |
|---|---|
| InnerException | null. |
| Message | The localized error message string. |
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .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 |
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
Initializes a new instance of the NullReferenceException class with a specified error message.
public:
NullReferenceException(System::String ^ message);C#
public NullReferenceException(string message);C#
public NullReferenceException(string? message);new NullReferenceException : string -> NullReferenceExceptionPublic Sub New (message As String)Parameters
- message
- String
A String that describes the error. The content of message 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.
Remarks
The following table shows the initial property values for an instance of NullReferenceException.
| Property | Value |
|---|---|
| InnerException | null. |
| Message | The error message string. |
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .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 |
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.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 NullReferenceException class with serialized data.
protected:
NullReferenceException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);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 NullReferenceException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);C#
protected NullReferenceException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);[<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}")>]
new NullReferenceException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> NullReferenceExceptionnew NullReferenceException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> NullReferenceExceptionProtected Sub New (info As SerializationInfo, context As StreamingContext)Parameters
- info
- SerializationInfo
The object that holds the serialized object data.
- context
- StreamingContext
The contextual information about the source or destination.
- 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 and other versions
| Product | Versions (Obsolete) |
|---|---|
| .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 |
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
- Source:
- NullReferenceException.cs
Initializes a new instance of the NullReferenceException class with a specified error message and a reference to the inner exception that is the cause of this exception.
public:
NullReferenceException(System::String ^ message, Exception ^ innerException);C#
public NullReferenceException(string message, Exception innerException);C#
public NullReferenceException(string? message, Exception? innerException);new NullReferenceException : string * Exception -> NullReferenceExceptionPublic Sub New (message As String, innerException As Exception)Parameters
- message
- String
The error message that explains the reason for the exception.
- innerException
- Exception
The exception that is the cause of the current exception. If the innerException parameter is not null, the current exception is raised in a catch block that handles the inner exception.
Remarks
An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.
The following table shows the initial property values for an instance of NullReferenceException.
| Property | Value |
|---|---|
| InnerException | The inner exception reference. |
| Message | The error message string. |
See also
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .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 |