Abortable class

DotNet 7.0 threading helper class. Behaves like Thread, except the following specials: - Abort() works similarly to previous runtime versions; - Abortable offers an additional property 'AbortableException'; - Abortable implements IDisposable. Usage: replace "new Thread..." with "new Abortable...", Call Dispose on Abortable-instance when it's no longer used. Attention: This class uses Run(Action, CancellationToken), which was released with.Net 7.0. Although this method is new, it has been marked as "deprecated"!

Inheritance hierarchy

SystemObject
NetEti.ApplicationControlAbortable

Namespace: NetEti.ApplicationControl
Assembly: NetEti.ProcessTools (in NetEti.ProcessTools.dll) Version: 1.0.0+3226eb04384bdec34e8eaa040302e1906383a7b4

Syntax

C++

Copy

public class Abortable

Public Class Abortable

public ref class Abortable

type Abortable = class end

The Abortable Type exposes the following members.

Constructors

	Name	Description of the
	Abortable(ParameterisedThreadStart)	Creates a new Abortable-instance for a parameterised thread.
	Abortable(ThreadStart)	Creates a new Abortable-instance for a parameterless thread.
	Abortable(ParameterisedThreadStart, Int32)	Creates a new Abortable-instance for a parameterised thread with a given maximum stack size.
	Abortable(ThreadStart, Int32)	Creates a new Abortable-instance for a parameterless thread with a given maximum stack size.

Back to the top

Properties

	Name	Description of the
	AbortableException	Contans an optional exception of the executed thread.
	ApartmentState	Obsolete. Is no longer supported.
	CurrentCulture	Contains the current culture.
	CurrentPrincipal	Contains the current principal or null.
	CurrentThread	Leads to the CurrentThread.
	CurrentUICulture	Contains the current ui-culture.
	ExecutionContext	Leads to Thread.ExecutionContext.
	IsAlive	Returns true if the thread has been started and is not dead.
	IsBackground	Return whether or not this thread is a background thread. Background threads do not affect when the Execution Engine shuts down.
	IsThreadPoolThread	Returns true if the thread is a threadpool thread.
	ManagedThreadId	Leads to the extern int thread-id.
	Name	Contains the thread-name or null.
	Priority	Returns the priority of the thread.
	ThreadState	Return the thread state as a consistent set of bits. This is more general then IsAlive or IsBackground.

Back to the top

Methods

	Name	Description of the
	Abortion	Throws a System.Threading.ThreadAbortException on the thread on which the call was done to start thread termination. By calling this method the thread is usually terminated. Exceptions: T:System.PlatformNotSupportedException: .NET Core only: This member is not supported. T:System.Security.SecurityException: The caller does not have the required permission. T:System.Threading.ThreadStateException: The thread that was killed is currently suspended.
	Abort(Object)	Obsolete. Is no longer supported. Throws a System.Threading.ThreadAbortException on the thread on which the call was done to start thread termination. By calling this method the thread is usually terminated. Exceptions: T:System.PlatformNotSupportedException: .NET Core only: This member is not supported. T:System.Security.SecurityException: The caller does not have the required permission. T:System.Threading.ThreadStateException: The thread that was killed is currently suspended.
	AllocateDataSlot	Leads to Thread.AllocateDataSlot().
	AllocateNamedDataSlot	Leads to Thread.AllocateNamedDataSlot(...).
	BeginCriticalRegion	Leads to Thread.BeginCriticalRegion().
	BeginThreadAffinity	Leads to Thread.BeginThreadAffinity().
	DisableComObjectEagerCleanup	Leads to the extern void DisableComObjectEagerCleanup.
	EndCriticalRegion	Leads to Thread.EndCriticalRegion().
	EndThreadAffinity	Leads to Thread.EndThreadAffinity().
	FreeNamedDataSlot	Leads to Thread.FreeNamedDataSlot(...).
	GetApartmentState	Leads to the internal Interop ApartmentState.
	GetCompressedStack	Obsolete. Is no longer supported.
	GetCurrentProcessorId	Returns the current processor-id.
	GetData	Leads to Thread.GetNamedDataSlot(...).
	GetDomain	Leads to Thread.GetDomain().
	GetDomainID	Leads to Thread.GetDomainID().
	GetHashCode	Leads to Thread.GetHashCode(). (Overwrites ObjectGetHashCode)
	GetNamedDataSlot	Leads to Thread.GetNamedDataSlot(...).
	GetThread	Returns the current helper-thread or null.
	Interrupt	Interrupts a thread that is inside a Wait(), Sleep() or Join(). If that thread is not currently blocked in that manner, it will be interrupted when it next begins to block.
	Join	Leads to Thread.Join().
	Join(Int32)	Waits for the thread to die or for timeout milliseconds to elapse.
	Join(TimeSpan)	Leads to Thread.Join(...).
	MemoryBarrier	Leads to Thread.MemoryBarrier.
	ResetAbort	Obsolete. Is no longer supported.
	Resume	Obsolete. Is no longer supported.
	SetApartmentState	Leads to Thread.SetApartmentState(...).
	SetCompressedStack	Obsolete. Is no longer supported.
	SetData	Leads to Thread.SetData(...).
	Sleep(Int32)	Suspends the current thread for timeout milliseconds. If timeout == 0, forces the thread to give up the remainder of its timeslice. If timeout == Timeout.Infinite, no timeout will occur.
	Sleep(TimeSpan)	Leads to Thread.Sleep(...).
	SpinWait	Wait for a length of time proportional to 'iterations'. Each iteration is should only take a few machine instructions. Calling this API is preferable to coding an explicit busy loop because the hardware can be informed that it is busy waiting.
	Start	Causes the operating system to change the state of the current instance to Running.
	Start(Object)	Causes the operating system to change the state of the current instance to Running, and optionally supplies an object containing data to be used by the method the thread executes.
	Suspend	Obsolete. Is no longer supported.
	TrySetApartmentState	Leads to Thread.TrySetApartmentState(...).
	UnsafeStart	Causes the operating system to change the state of the current instance to Running.
	UnsafeStart(Object)	Causes the operating system to change the state of the current instance to Running, and optionally supplies an object containing data to be used by the method the thread executes.
	VolatileRead(Byte)	Leads to Thread.VolatileRead(...).
	VolatileRead(Double)	Leads to Thread.VolatileRead(...).
	VolatileRead(Int16)	Leads to Thread.VolatileRead(...).
	VolatileRead(Int32)	Leads to Thread.VolatileRead(...).
	VolatileRead(Int64)	Leads to Thread.VolatileRead(...).
	VolatileRead(IntPtr)	Leads to Thread.VolatileRead(...).
	VolatileRead(Object)	Leads to Thread.VolatileRead(...).
	VolatileRead(SByte)	Leads to Thread.VolatileRead(...).
	VolatileRead(Single)	Leads to Thread.VolatileRead(...).
	VolatileRead(UInt16)	Leads to Thread.VolatileRead(...).
	VolatileRead(UInt32)	Leads to Thread.VolatileRead(...).
	VolatileRead(UInt64)	Leads to Thread.VolatileRead(...).
	VolatileRead(UIntPtr)	Leads to Thread.VolatileRead(...).
	VolatileWrite(Bytebyte)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(DoubleDouble)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(Int16, Int16)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(Int32, Int32)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(Int64, Int64)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(IntPtr, IntPtr)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(Object, Object)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(SByte, SByte)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(Single, Single)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(UInt16, UInt16)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(UInt32, UInt32)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(UInt64, UInt64)	Leads to Thread.VolatileWrite(...).
	VolatileWrite(UIntPtr, UIntPtr)	Leads to Thread.VolatileWrite(...).
	Yield	Leads to YieldInternal.

Back to the top

Remarks

17.03.2023 Erik Nagel: created. 06.08.2023 Erik Nagel: Added missing comments.

Reference

NetEti.ApplicationControl namespace