ThreadInterruptedException Classe

Definizione

Spazio dei nomi:

System.Threading

Assembly:

mscorlib.dll

Eccezione generata quando un Thread oggetto viene interrotto mentre si trova in uno stato di attesa.

public ref class ThreadInterruptedException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ThreadInterruptedException : SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ThreadInterruptedException = class
    inherit SystemException

Public Class ThreadInterruptedException
Inherits SystemException

Ereditarietà

Object

Exception

SystemException

ThreadInterruptedException

Attributi

SerializableAttribute ComVisibleAttribute

Esempio

Nell'esempio di codice seguente viene illustrato il comportamento di un thread in esecuzione quando viene interrotto e successivamente viene bloccato.

using System;
using System.Security.Permissions;
using System.Threading;

class ThreadInterrupt
{
    static void Main()
    {
        StayAwake stayAwake = new StayAwake();
        Thread newThread = 
            new Thread(new ThreadStart(stayAwake.ThreadMethod));
        newThread.Start();

        // The following line causes an exception to be thrown 
        // in ThreadMethod if newThread is currently blocked
        // or becomes blocked in the future.
        newThread.Interrupt();
        Console.WriteLine("Main thread calls Interrupt on newThread.");

        // Tell newThread to go to sleep.
        stayAwake.SleepSwitch = true;

        // Wait for newThread to end.
        newThread.Join();
    }
}

class StayAwake
{
    bool sleepSwitch = false;

    public bool SleepSwitch
    {
        set{ sleepSwitch = value; }
    }

    public StayAwake(){}

    public void ThreadMethod()
    {
        Console.WriteLine("newThread is executing ThreadMethod.");
        while(!sleepSwitch)
        {
            // Use SpinWait instead of Sleep to demonstrate the 
            // effect of calling Interrupt on a running thread.
            Thread.SpinWait(10000000);
        }
        try
        {
            Console.WriteLine("newThread going to sleep.");

            // When newThread goes to sleep, it is immediately 
            // woken up by a ThreadInterruptedException.
            Thread.Sleep(Timeout.Infinite);
        }
        catch(ThreadInterruptedException e)
        {
            Console.WriteLine("newThread cannot go to sleep - " +
                "interrupted by main thread.");
        }
    }
}

Option Explicit
Option Strict

Imports System.Security.Permissions
Imports System.Threading

Public Class ThreadInterrupt

    <MTAThread> _
    Shared Sub Main()
        Dim stayAwake As New StayAwake()
        Dim newThread As New Thread(AddressOf stayAwake.ThreadMethod)
        newThread.Start()

        ' The following line causes an exception to be thrown 
        ' in ThreadMethod if newThread is currently blocked
        ' or becomes blocked in the future.
        newThread.Interrupt()
        Console.WriteLine("Main thread calls Interrupt on newThread.")

        ' Tell newThread to go to sleep.
        stayAwake.SleepSwitch = True

        ' Wait for newThread to end.
        newThread.Join()
    End Sub

End Class

Public Class StayAwake

    Dim sleepSwitchValue As Boolean = False

    WriteOnly Property SleepSwitch As Boolean
        Set
            sleepSwitchValue = Value
        End Set
    End Property 

    Sub New()
    End Sub

    Sub ThreadMethod()
        Console.WriteLine("newThread is executing ThreadMethod.")
        While Not sleepSwitchValue

            ' Use SpinWait instead of Sleep to demonstrate the 
            ' effect of calling Interrupt on a running thread.
            Thread.SpinWait(10000000)
        End While
        Try
            Console.WriteLine("newThread going to sleep.")

            ' When newThread goes to sleep, it is immediately 
            ' woken up by a ThreadInterruptedException.
            Thread.Sleep(Timeout.Infinite)
        Catch ex As ThreadInterruptedException
            Console.WriteLine("newThread cannot go to " & _
                "sleep - interrupted by main thread.")
        End Try
    End Sub

End Class

Commenti

Dopo aver creato un thread, si trova in uno o più ThreadState stati fino a quando non viene eliminato definitivamente. La chiamata quando Interrupt un thread si trova nello WaitSleepJoin stato causerà un'eccezione ThreadInterruptedException nel thread di destinazione. Se il thread non è nello WaitSleepJoin stato , l'eccezione non viene generata finché il thread non entra in tale stato. Se il thread non si blocca mai, potrebbe essere completato senza mai essere interrotto.

ThreadInterruptedException usa il COR_E_THREADINTERRUPTED HRESULT, che ha il valore 0x80131519.

Per un elenco dei valori iniziali delle proprietà per un'istanza di ThreadInterruptedException, consultare i costruttori di ThreadInterruptedException.

Costruttori

Nome	Descrizione
ThreadInterruptedException()	Inizializza una nuova istanza della ThreadInterruptedException classe con le proprietà predefinite.
ThreadInterruptedException(SerializationInfo, StreamingContext)	Inizializza una nuova istanza della classe ThreadInterruptedException con dati serializzati.
ThreadInterruptedException(String, Exception)	Inizializza una nuova istanza della classe ThreadInterruptedException con un messaggio di errore specificato e un riferimento all'eccezione interna che è la causa di questa eccezione.
ThreadInterruptedException(String)	Inizializza una nuova istanza della ThreadInterruptedException classe con un messaggio di errore specificato.

Proprietà

Nome	Descrizione
Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni aggiuntive definite dall'utente sull'eccezione. (Ereditato da Exception)
HelpLink	Ottiene o imposta un collegamento al file della Guida associato a questa eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, valore numerico codificato assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
Message	Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception)
Source	Ottiene o imposta il nome dell'applicazione o dell'oggetto che causa l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei fotogrammi immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando sottoposto a override in una classe derivata, restituisce l'oggetto Exception che rappresenta la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)	In caso di override in una classe derivata, imposta con le SerializationInfo informazioni sull'eccezione. (Ereditato da Exception)
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Crea e restituisce una rappresentazione di stringa dell'eccezione corrente. (Ereditato da Exception)

Eventi

Nome	Descrizione
SerializeObjectState	Si verifica quando viene serializzata un'eccezione per creare un oggetto stato dell'eccezione contenente dati serializzati sull'eccezione. (Ereditato da Exception)

Vedi anche

• Thread
• ThreadState
• Sospensione e ripresa dei thread