HandleProcessCorruptedStateExceptionsAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

HandleProcessCorruptedStateExceptionsAttribute

Attributi

AttributeUsageAttribute ObsoleteAttribute

Commenti

Le eccezioni dello stato del processo danneggiato sono eccezioni che indicano che lo stato di un processo è stato danneggiato. Non è consigliabile eseguire l'applicazione in questo stato.

Per impostazione predefinita, Common Language Runtime (CLR) non recapita queste eccezioni al codice gestito e i try/catch blocchi (e altre clausole di gestione delle eccezioni) non vengono richiamati per loro. Se si è certi di voler mantenere la gestione di queste eccezioni, è necessario applicare l'attributo HandleProcessCorruptedStateExceptionsAttribute al metodo le cui clausole di gestione delle eccezioni si desidera eseguire. CLR fornisce l'eccezione di stato del processo danneggiato alle clausole di eccezione applicabili solo nei metodi con attributi HandleProcessCorruptedStateExceptionsAttribute e SecurityCriticalAttribute .

È anche possibile aggiungere l'elemento <legacyCorruptedStateExceptionsPolicy> al file di configurazione dell'applicazione. In questo modo si garantisce che le eccezioni di stato danneggiate vengano recapitate ai gestori di eccezioni senza l'attributo HandleProcessCorruptedStateExceptionsAttribute o SecurityCriticalAttribute . Questo elemento di configurazione non ha alcun effetto sulle applicazioni compilate nelle versioni precedenti a .NET Framework 4, ma in esecuzione in .NET Framework 4 o versioni successive; Le eccezioni di stato danneggiate continueranno a essere recapitate per tali applicazioni. L'attributo HandleProcessCorruptedStateExceptionsAttribute viene ignorato quando viene rilevato in codice parzialmente attendibile o trasparente, perché un host attendibile non deve consentire a un componente aggiuntivo non attendibile di intercettare e ignorare queste gravi eccezioni.

Per altre informazioni sulle eccezioni di stato del processo danneggiato, vedere la voce Gestione delle eccezioni dello stato danneggiato nel blog CLR Inside Out.

Solo .NET Core: Anche se questo attributo esiste in .NET Core, poiché il ripristino da eccezioni di stato del processo danneggiato non è supportato, questo attributo viene ignorato. CLR non recapita eccezioni di stato del processo danneggiate al codice gestito.