Compartilhar via


InsufficientMemoryException Classe

Definição

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)

Aplica-se a

Confira também