InsufficientMemoryException Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
A exceção é lançada quando falha uma verificação de memória disponível suficiente. Esta classe não pode ser herdada.
public ref class InsufficientMemoryException sealed : OutOfMemoryException[System.Serializable]
public sealed class InsufficientMemoryException : OutOfMemoryExceptionpublic sealed class InsufficientMemoryException : OutOfMemoryException[<System.Serializable>]
type InsufficientMemoryException = class
inherit OutOfMemoryExceptiontype InsufficientMemoryException = class
inherit OutOfMemoryExceptionPublic NotInheritable Class InsufficientMemoryException
Inherits OutOfMemoryException- Herança
- Atributos
Observações
Ao contrário de OutOfMemoryException, InsufficientMemoryException é lançado antes de iniciar uma operação, e assim não implica corrupção de estado. Uma aplicação pode detetar esta exceção, reduzir o seu uso de memória e evitar condições reais de falta de memória e o seu potencial para corromper o estado do programa.
Esta exceção é lançada pelo MemoryFailPoint construtor quando especifica uma alocação de memória projetada maior do que a quantidade de memória atualmente disponível. O teu programa pode detetar a exceção e atrasar a tarefa que precisa da memória ou executá-la em passos mais pequenos que requerem menos memória.
Veja a MemoryFailPoint classe para um exemplo de código.
Note
Esta exceção não está incluída no .NET para aplicações Windows Store nem na Portable Class Library, mas é lançada por alguns membros que são. Para apanhar a exceção nesse caso, escreva uma catch instrução para OutOfMemoryException em vez disso.
Construtores
| Name | Description |
|---|---|
| InsufficientMemoryException() |
Inicializa uma nova instância da InsufficientMemoryException classe com uma mensagem fornecida pelo sistema que descreve o erro. |
| InsufficientMemoryException(String, Exception) |
Inicializa uma nova instância da InsufficientMemoryException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção. |
| InsufficientMemoryException(String) |
Inicializa uma nova instância da InsufficientMemoryException classe com uma mensagem especificada que descreve o erro. |
Propriedades
| Name | Description |
|---|---|
| Data |
Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception) |
| HelpLink |
Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception) |
| HResult |
Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Obtém a Exception instância que causou a exceção atual. (Herdado de Exception) |
| Message |
Recebe uma mensagem que descreve a exceção atual. (Herdado de Exception) |
| Source |
Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que lança a exceção atual. (Herdado de Exception) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Quando sobreposto numa classe derivada, define a SerializationInfo informação com sobre a exceção. (Herdado de Exception) |
| GetType() |
Obtém o tipo de execução da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Cria e devolve uma representação string da exceção atual. (Herdado de Exception) |
evento
| Name | Description |
|---|---|
| SerializeObjectState |
Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception) |