HandleProcessCorruptedStateExceptionsAttribute Classe

Definição

Namespace:

System.Runtime.ExceptionServices

Assembly:

System.Runtime.dll

Origem:

HandleProcessCorruptedStateExceptionsAttribute.cs

Cuidado

Recovery from corrupted process state exceptions is not supported; HandleProcessCorruptedStateExceptionsAttribute is ignored.

Habilita o código gerenciado para tratar exceções que indicam um estado de processo corrompido.

public ref class HandleProcessCorruptedStateExceptionsAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)]
[System.Obsolete("Recovery from corrupted process state exceptions is not supported; HandleProcessCorruptedStateExceptionsAttribute is ignored.", DiagnosticId="SYSLIB0032", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class HandleProcessCorruptedStateExceptionsAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
[<System.Obsolete("Recovery from corrupted process state exceptions is not supported; HandleProcessCorruptedStateExceptionsAttribute is ignored.", DiagnosticId="SYSLIB0032", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type HandleProcessCorruptedStateExceptionsAttribute = class
    inherit Attribute

Public NotInheritable Class HandleProcessCorruptedStateExceptionsAttribute
Inherits Attribute

Herança

Object

Attribute

HandleProcessCorruptedStateExceptionsAttribute

Atributos

AttributeUsageAttribute ObsoleteAttribute

Comentários

Exceções de estado de processo corrompido são exceções que indicam que o estado de um processo foi corrompido. Não recomendamos executar seu aplicativo nesse estado.

Por padrão, o CLR (Common Language Runtime) não fornece essas exceções ao código gerenciado e os try/catch blocos (e outras cláusulas de tratamento de exceção) não são invocados para eles. Se você tiver certeza absoluta de que deseja manter o tratamento dessas exceções, deverá aplicar o HandleProcessCorruptedStateExceptionsAttribute atributo ao método cujas cláusulas de tratamento de exceção você deseja executar. O CLR fornece a exceção de estado do processo corrompido para cláusulas de exceção aplicáveis somente em métodos que têm os HandleProcessCorruptedStateExceptionsAttribute atributos e SecurityCriticalAttribute .

Você também pode adicionar o <elemento legacyCorruptedStateExceptionsPolicy> ao arquivo de configuração do aplicativo. Isso garantirá que exceções de estado corrompido sejam entregues aos manipuladores de exceção sem o HandleProcessCorruptedStateExceptionsAttribute atributo ou SecurityCriticalAttribute . Esse elemento de configuração não tem efeito sobre aplicativos que foram compilados em versões anteriores ao .NET Framework 4, mas estão em execução no .NET Framework 4 ou posterior; exceções de estado corrompido continuarão a ser entregues para esses aplicativos. O HandleProcessCorruptedStateExceptionsAttribute atributo é ignorado quando é encontrado em código parcialmente confiável ou transparente, pois um host confiável não deve permitir que um suplemento não confiável capture e ignore essas exceções graves.

Para obter mais informações sobre exceções de estado de processo corrompido, consulte a entrada Manipulando exceções de estado corrompido no blog do CLR Inside Out.

Somente .NET Core: Embora esse atributo exista no .NET Core, como não há suporte para a recuperação de exceções de estado de processo corrompido, esse atributo é ignorado. O CLR não fornece exceções de estado de processo corrompido para o código gerenciado.

Construtores

HandleProcessCorruptedStateExceptionsAttribute()

Obsoleto. Inicializa uma nova instância da classe HandleProcessCorruptedStateExceptionsAttribute.

Propriedades

TypeId

Obsoleto. Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Obsoleto. Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Obsoleto. Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obsoleto. Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Obsoleto. Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Obsoleto. Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Obsoleto. Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Obsoleto. Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)