Environment.HasShutdownStarted Property

Definition

Gets a value that indicates whether the current application domain is being unloaded or the common language runtime (CLR) is shutting down.

C#
public static bool HasShutdownStarted { get; }

Property Value

true if the current application domain is being unloaded or the CLR is shutting down; otherwise, false.

Remarks

.NET Framework only: When the CLR unloads an application domain, it runs the finalizers on all objects that have a finalizer method in that application domain. When the CLR shuts down, it starts the finalizer thread on all objects that have a finalizer method. The HasShutdownStarted property returns true only after the finalizer thread has been started. When the property returns true, you can determine whether an application domain is being unloaded or the CLR itself is shutting down by calling the AppDomain.IsFinalizingForUnload method. This method returns true if finalizers are called because the application domain is unloading or false if the CLR is shutting down.

The HasShutdownStarted property returns false if the finalizer thread has not been started.

By using this property, you can determine whether to access static variables in your finalization code. If either an application domain or the CLR is shutting down, you cannot reliably access any object that has a finalization method and that is referenced by a static field. This is because these objects may have already been finalized.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

See also