InsufficientMemoryException Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
A exceção lançada quando ocorre falha em uma verificação de memória suficiente disponível. Essa classe não pode ser herdada.
public ref class InsufficientMemoryException sealed : OutOfMemoryException
public sealed class InsufficientMemoryException : OutOfMemoryException
[System.Serializable]
public sealed class InsufficientMemoryException : OutOfMemoryException
type InsufficientMemoryException = class
inherit OutOfMemoryException
[<System.Serializable>]
type InsufficientMemoryException = class
inherit OutOfMemoryException
Public NotInheritable Class InsufficientMemoryException
Inherits OutOfMemoryException
- Herança
- Atributos
Comentários
Ao contrário OutOfMemoryExceptionde , InsufficientMemoryException é lançada antes de iniciar uma operação e, portanto, não implica corrupção estatal. Um aplicativo pode capturar essa exceção, restringir o uso de memória e evitar condições reais fora da memória e seu potencial de corromper o estado do programa.
Essa exceção é gerada pelo MemoryFailPoint construtor quando você especifica uma alocação de memória projetada maior que a quantidade de memória disponível no momento. Seu programa pode capturar a exceção e atrasar a tarefa que precisa da memória ou executá-la em etapas menores que exigem menos memória.
Consulte a MemoryFailPoint classe para obter um exemplo de código.
Observação
Essa exceção não está incluída no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, mas é gerada por alguns membros que são. Para capturar a exceção nesse caso, escreva uma catch
instrução.OutOfMemoryException
Construtores
InsufficientMemoryException() |
Inicializa uma nova instância da classe InsufficientMemoryException com uma mensagem fornecida pelo sistema que descreve o erro. |
InsufficientMemoryException(String) |
Inicializa uma nova instância da classe InsufficientMemoryException com uma mensagem especificada que descreve o erro. |
InsufficientMemoryException(String, Exception) |
Inicializa uma nova instância da classe InsufficientMemoryException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção. |
Propriedades
Data |
Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção. (Herdado de Exception) |
HelpLink |
Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception) |
HResult |
Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception) |
InnerException |
Obtém a instância Exception que causou a exceção atual. (Herdado de Exception) |
Message |
Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception) |
Source |
Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception) |
StackTrace |
Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception) |
TargetSite |
Obtém o método que gerou a exceção atual. (Herdado de Exception) |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetBaseException() |
Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetObjectData(SerializationInfo, StreamingContext) |
Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção. (Herdado de Exception) |
GetType() |
Obtém o tipo de runtime da instância atual. (Herdado de Exception) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception) |
Eventos
SerializeObjectState |
Obsoleto.
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) |