InsufficientMemoryException Klasa

Definicja

Wyjątek, który jest generowany, gdy sprawdzenie dostępności wystarczającej ilości pamięci nie powiedzie się.The exception that is thrown when a check for sufficient available memory fails. Klasa ta nie może być dziedziczona.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
Dziedziczenie
Atrybuty

Uwagi

W przeciwieństwie do OutOfMemoryException, InsufficientMemoryException jest generowany przed rozpoczęciem operacji, więc nie oznacza to uszkodzenia stanu.Unlike OutOfMemoryException, InsufficientMemoryException is thrown before starting an operation, and thus does not imply state corruption. Aplikacja może przechwytywać ten wyjątek, ograniczać użycie pamięci i uniknąć faktycznych warunków braku pamięci i ich potencjalną przyczyną uszkodzenia stanu programu.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.

Ten wyjątek jest zgłaszany przez konstruktora MemoryFailPoint w przypadku określenia przydziału pamięci przewidywanej większej niż ilość aktualnie dostępnej pamięci.This exception is thrown by the MemoryFailPoint constructor when you specify a projected memory allocation larger than the amount of currently available memory. Program może przechwycić wyjątek, a następnie opóźnić zadanie wymagające pamięci lub wykonać je w mniejszych krokach, które wymagają mniejszej ilości pamięci.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.

Zapoznaj się z klasą MemoryFailPoint, aby zapoznać się z przykładem kodu.See the MemoryFailPoint class for a code example.

Uwaga

Ten wyjątek nie jest zawarty w platformie .NET dla aplikacji ze sklepu Windows lub przenośnej biblioteki klas, ale jest zgłaszany przez niektórych członków.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. Aby przechwytywać wyjątek w tym przypadku, należy napisać catch instrukcji dla OutOfMemoryException zamiast tego.To catch the exception in that case, write a catch statement for OutOfMemoryException instead.

Konstruktory

InsufficientMemoryException()

Inicjuje nowe wystąpienie klasy InsufficientMemoryException z komunikatem dostarczonym przez system, który opisuje błąd.Initializes a new instance of the InsufficientMemoryException class with a system-supplied message that describes the error.

InsufficientMemoryException(String)

Inicjuje nowe wystąpienie klasy InsufficientMemoryException z określonym komunikatem opisującym błąd.Initializes a new instance of the InsufficientMemoryException class with a specified message that describes the error.

InsufficientMemoryException(String, Exception)

Inicjuje nowe wystąpienie klasy InsufficientMemoryException klasy przy użyciu określonego komunikatu o błędzie i odwołania do wewnętrznego wyjątku, który jest przyczyną tego wyjątku.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.

Właściwości

Data

Pobiera kolekcję par klucz/wartość, które zawierają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Odziedziczone po Exception)
HelpLink

Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem.Gets or sets a link to the help file associated with this exception.

(Odziedziczone po Exception)
HResult

Pobiera lub ustawia wartość HRESULT, kodowane wartości liczbowe przypisane do określonego wyjątku.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Odziedziczone po Exception)
InnerException

Pobiera wystąpienie Exception, które spowodowało wyjątek bieżący.Gets the Exception instance that caused the current exception.

(Odziedziczone po Exception)
Message

Pobiera komunikat, który opisuje bieżący wyjątek.Gets a message that describes the current exception.

(Odziedziczone po Exception)
Source

Pobiera lub ustawia nazwę aplikacji lub obiekt, który powoduje błąd.Gets or sets the name of the application or the object that causes the error.

(Odziedziczone po Exception)
StackTrace

Pobiera ciąg reprezentujący bezpośrednie ramki w stosie wywołań.Gets a string representation of the immediate frames on the call stack.

(Odziedziczone po Exception)
TargetSite

Pobiera metodę, która zgłasza bieżący wyjątek.Gets the method that throws the current exception.

(Odziedziczone po Exception)

Metody

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetBaseException()

Gdy jest zastępowany w klasie pochodnej, zwraca Exception, który jest główną przyczyną jednego lub kilku kolejnych wyjątków.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Odziedziczone po Exception)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)

Gdy jest zastępowany w klasie pochodnej, ustawia SerializationInfo z informacjami o wyjątku.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Odziedziczone po Exception)
GetType()

Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia.Gets the runtime type of the current instance.

(Odziedziczone po Exception)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.Creates and returns a string representation of the current exception.

(Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Odziedziczone po Exception)

Dotyczy

Zobacz też