InsufficientMemoryException InsufficientMemoryException InsufficientMemoryException InsufficientMemoryException Class

定义

当检测到没有足够的可用内存时引发的异常。The exception that is thrown when a check for sufficient available memory fails. 此类不能被继承。This class cannot be inherited.

public ref class InsufficientMemoryException sealed : OutOfMemoryException
[System.Serializable]
public sealed class InsufficientMemoryException : OutOfMemoryException
type InsufficientMemoryException = class
    inherit OutOfMemoryException
Public NotInheritable Class InsufficientMemoryException
Inherits OutOfMemoryException
继承
属性

注解

OutOfMemoryException不同InsufficientMemoryException , 在启动操作之前引发, 因此不表示状态损坏。Unlike OutOfMemoryException, InsufficientMemoryException is thrown before starting an operation, and thus does not imply state corruption. 应用程序可以捕获此异常、限制其内存使用情况, 并避免实际内存不足的情况, 并可避免程序状态损坏。An application can catch this exception, throttle back its memory usage, and avoid actual out of memory conditions and their potential for corrupting program state.

当指定的投影内存分配MemoryFailPoint大于当前可用内存量时, 构造函数将引发此异常。This exception is thrown by the MemoryFailPoint constructor when you specify a projected memory allocation larger than the amount of currently available memory. 您的程序可以捕获异常, 延迟需要内存的任务, 或在需要较少内存的小步骤中执行该任务。Your program can catch the exception and either delay the task that needs the memory or execute it in smaller steps that require less memory.

有关代码示例, 请参阅类。MemoryFailPointSee the MemoryFailPoint class for a code example.

备注

Windows 应用商店应用可移植类库中未包含此异常, 但它由某些成员引发。This exception is not included in the .NET for Windows Store apps or the Portable Class Library, but it is thrown by some members that are. 若要在这种情况下捕获异常, catch请改OutOfMemoryException为编写一条语句。To catch the exception in that case, write a catch statement for OutOfMemoryException instead.

构造函数

InsufficientMemoryException() InsufficientMemoryException() InsufficientMemoryException() InsufficientMemoryException()

使用由系统提供的用于描述错误的消息初始化 InsufficientMemoryException 类的新实例。Initializes a new instance of the InsufficientMemoryException class with a system-supplied message that describes the error.

InsufficientMemoryException(String) InsufficientMemoryException(String) InsufficientMemoryException(String) InsufficientMemoryException(String)

使用指定的描述错误的消息初始化 InsufficientMemoryException 类的新实例。Initializes a new instance of the InsufficientMemoryException class with a specified message that describes the error.

InsufficientMemoryException(String, Exception) InsufficientMemoryException(String, Exception) InsufficientMemoryException(String, Exception) InsufficientMemoryException(String, Exception)

使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 InsufficientMemoryException 类的新实例。Initializes a new instance of the InsufficientMemoryException class with a specified error message and a reference to the inner exception that is the cause of this exception.

属性

Data Data Data Data

获取提供有关异常的其他用户定义信息的键/值对集合。Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

获取或设置指向与此异常关联的帮助文件链接。Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

获取或设置 HRESULT(一个分配给特定异常的编码数字值)。Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

获取导致当前异常的 Exception 实例。Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

获取描述当前异常的消息。Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

获取或设置导致错误的应用程序或对象的名称。Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

获取调用堆栈上的即时框架字符串表示形式。Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

获取引发当前异常的方法。Gets the method that throws the current exception.

(Inherited from Exception)

方法

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

当在派生类中重写时,返回 Exception,它是一个或多个并发的异常的根源。When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

当在派生类中重写时,用关于异常的信息设置 SerializationInfoWhen overridden in a derived class, sets the SerializationInfo with information about the exception.

(Inherited from Exception)
GetType() GetType() GetType() GetType()

获取当前实例的运行时类型。Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

创建并返回当前异常的字符串表示形式。Creates and returns a string representation of the current exception.

(Inherited from Exception)

事件

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

适用于

另请参阅