OutOfMemoryException Constructors

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Initializes a new instance of the OutOfMemoryException class.

Overloads

OutOfMemoryException()	Initializes a new instance of the OutOfMemoryException class.
OutOfMemoryException(String)	Initializes a new instance of the OutOfMemoryException class with a specified error message.
OutOfMemoryException(SerializationInfo, StreamingContext)	Obsolete. Initializes a new instance of the OutOfMemoryException class with serialized data.
OutOfMemoryException(String, Exception)	Initializes a new instance of the OutOfMemoryException class with a specified error message and a reference to the inner exception that is the cause of this exception.

OutOfMemoryException()

Source:

OutOfMemoryException.cs

Initializes a new instance of the OutOfMemoryException class.

public:
 OutOfMemoryException();

public OutOfMemoryException ();

Public Sub New ()

Remarks

This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "There was not enough memory to continue the execution of the program." This message takes into account the current system culture.

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

Property	Value
InnerException	null.
Message	The localized error message string.

OutOfMemoryException(String)

Source:

OutOfMemoryException.cs

Initializes a new instance of the OutOfMemoryException class with a specified error message.

public:
 OutOfMemoryException(System::String ^ message);

public OutOfMemoryException (string? message);

new OutOfMemoryException : string -> OutOfMemoryException

Public Sub New (message As String)

Parameters

message

String

The message that describes the error.

Remarks

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 OutOfMemoryException.

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

OutOfMemoryException(SerializationInfo, StreamingContext)

Source:

OutOfMemoryException.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 OutOfMemoryException class with serialized data.

protected:
 OutOfMemoryException(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}")]
protected OutOfMemoryException (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 OutOfMemoryException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> OutOfMemoryException

Protected 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

ObsoleteAttribute

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

• XML and SOAP Serialization

OutOfMemoryException(String, Exception)

Source:

OutOfMemoryException.cs

Initializes a new instance of the OutOfMemoryException class with a specified error message and a reference to the inner exception that is the cause of this exception.

public:
 OutOfMemoryException(System::String ^ message, Exception ^ innerException);

public OutOfMemoryException (string? message, Exception? innerException);

new OutOfMemoryException : string * Exception -> OutOfMemoryException

Public 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 a null reference (Nothing in Visual Basic), 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 can 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 a null reference (Nothing in Visual Basic) 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 OutOfMemoryException.

Property	Value
InnerException	The inner exception reference.
Message	The error message string.

See also

• Exception
• Handling and Throwing Exceptions