HandleProcessCorruptedStateExceptionsAttribute Classe

Définition

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)]
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

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
type HandleProcessCorruptedStateExceptionsAttribute = class
    inherit Attribute

Public NotInheritable Class HandleProcessCorruptedStateExceptionsAttribute
Inherits Attribute

Héritage

Object

Attribute

HandleProcessCorruptedStateExceptionsAttribute

Attributs

AttributeUsageAttribute ObsoleteAttribute

Remarques

Les exceptions d’état de processus endommagées sont des exceptions qui indiquent que l’état d’un processus a été endommagé. Nous vous déconseillons d’exécuter votre application dans cet état.

Par défaut, le Common Language Runtime (CLR) ne remet pas ces exceptions au code managé, et les try/catch blocs (et autres clauses de gestion des exceptions) ne sont pas appelés pour eux. Si vous êtes absolument sûr que vous souhaitez conserver votre gestion de ces exceptions, vous devez appliquer l’attribut HandleProcessCorruptedStateExceptionsAttribute à la méthode dont vous souhaitez exécuter les clauses de gestion des exceptions. Le CLR remet l’exception d’état de processus endommagé aux clauses d’exception applicables uniquement dans les méthodes qui ont à la fois les attributs et SecurityCriticalAttribute les HandleProcessCorruptedStateExceptionsAttribute attributs.

Vous pouvez également ajouter l’élément <legacyCorruptedStateExceptionsPolicy> au fichier de configuration de votre application. Cela garantit que les exceptions d’état endommagées sont remises à vos gestionnaires d’exceptions sans l’attribut ou SecurityCriticalAttribute l’attributHandleProcessCorruptedStateExceptionsAttribute. Cet élément de configuration n’a aucun effet sur les applications compilées dans les versions antérieures au .NET Framework 4, mais qui s’exécutent dans .NET Framework 4 ou version ultérieure ; les exceptions d’état endommagées continueront d’être remises pour ces applications. L’attribut HandleProcessCorruptedStateExceptionsAttribute est ignoré lorsqu’il est rencontré dans du code partiellement approuvé ou transparent, car un hôte approuvé ne doit pas autoriser un complément non approuvé à intercepter et ignorer ces exceptions graves.

Pour plus d’informations sur les exceptions d’état de processus endommagés, consultez le blog de gestion des exceptions d’état endommagé dans le blog CLR Inside Out.

.NET Core uniquement : Même si cet attribut existe dans .NET Core, étant donné que la récupération à partir d’exceptions d’état de processus endommagés n’est pas prise en charge, cet attribut est ignoré. Le CLR ne remet pas d’exceptions d’état de processus endommagés au code managé.