InsufficientMemoryException Класс

Определение

Исключение, возникающее при сбое проверки наличия необходимого объема памяти.The exception that is thrown when a check for sufficient available memory fails. Этот класс не наследуется.This class cannot be inherited.

public ref class InsufficientMemoryException sealed : OutOfMemoryException
public sealed class InsufficientMemoryException : OutOfMemoryException
[System.Serializable]
public sealed class InsufficientMemoryException : OutOfMemoryException
type InsufficientMemoryException = class
    inherit OutOfMemoryException
Public NotInheritable Class InsufficientMemoryException
Inherits OutOfMemoryException
Наследование
InsufficientMemoryException
Наследование
Атрибуты

Комментарии

В отличие от 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.

Пример кода см. в разделе класс MemoryFailPoint.See the MemoryFailPoint class for a code example.

Примечание

Это исключение не включено в .NET для приложений Магазина 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 с системным сообщением, содержащим описание ошибки.Initializes a new instance of the InsufficientMemoryException class with a system-supplied message that describes the error.

InsufficientMemoryException(String)

Инициализирует новый экземпляр класса InsufficientMemoryException с использованием заданного сообщения, содержащего описание ошибки.Initializes a new instance of the InsufficientMemoryException class with a specified message that describes the error.

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

Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Унаследовано от Exception)
HelpLink

Получает или задает ссылку на файл справки, связанный с этим исключением.Gets or sets a link to the help file associated with this exception.

(Унаследовано от Exception)
HResult

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Унаследовано от Exception)
InnerException

Возвращает экземпляр класса Exception, который вызвал текущее исключение.Gets the Exception instance that caused the current exception.

(Унаследовано от Exception)
Message

Возвращает сообщение, описывающее текущее исключение.Gets a message that describes the current exception.

(Унаследовано от Exception)
Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.Gets or sets the name of the application or the object that causes the error.

(Унаследовано от Exception)
StackTrace

Получает строковое представление непосредственных кадров в стеке вызова.Gets a string representation of the immediate frames on the call stack.

(Унаследовано от Exception)
TargetSite

Возвращает метод, создавший текущее исключение.Gets the method that throws the current exception.

(Унаследовано от Exception)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetBaseException()

При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Унаследовано от Exception)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)

При переопределении в производном классе задает объект SerializationInfo со сведениями об исключении.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Унаследовано от Exception)
GetType()

Возвращает тип среды выполнения текущего экземпляра.Gets the runtime type of the current instance.

(Унаследовано от Exception)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Создает и возвращает строковое представление текущего исключения.Creates and returns a string representation of the current exception.

(Унаследовано от Exception)

События

SerializeObjectState

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Унаследовано от Exception)

Применяется к

Дополнительно