Open.Disposable
3.0.0
See the version list below for details.
dotnet add package Open.Disposable --version 3.0.0
NuGet\Install-Package Open.Disposable -Version 3.0.0
<PackageReference Include="Open.Disposable" Version="3.0.0" />
paket add Open.Disposable --version 3.0.0
#r "nuget: Open.Disposable, 3.0.0"
// Install Open.Disposable as a Cake Addin #addin nuget:?package=Open.Disposable&version=3.0.0 // Install Open.Disposable as a Cake Tool #tool nuget:?package=Open.Disposable&version=3.0.0
Open.Disposable
Provides a set of useful classes when implementing a disposable.
Core principles
- For most use cases, disposal should only occur once and be final.
- Implementing
IDisposable
in combination withIAsyncDisposable
is not typical and should be avoided. The consumer should understand the difference. .Dispose()
and.DisposeAsync()
should be thread-safe and calling either multiple times should not block or throw. (Typically done through an interlock method.)
Avoid anti-patterns
Memory
It can be all too easy to allocate more memory by constructing more classes or starting new tasks in order to complete disposal. This is counter to the intention of cleaning up a class and reducing the amount of work the garbage collector has to do.
Plan for the worst, but code for the best
Thread safety is important and in many cases should be assured. But when the 99% case is the local use of a class, over-engineering can simply create unnecessary overhead and contention.
Let the GC do its job
Aggressively attempting to help out the garbage collector can be a serious anti-pattern as you are simply slowing down your own application in order to avoid GC operations which might actually be helping your performance in total by deferring cleanup.
Classes
DisposableBase
Simply implement void OnDispose()
in order to manage disposal.
Note:
DisposableBase
exposes aBeforeDispose
event which will be triggered once just before disposing commences. This allows for others to react to this disposal event. TheDisposableBase
is still considered 'live' until after theBeforeDispose
event cycle has completed.
AsyncDisposableBase
Simply implement ValueTask OnDisposeAsync()
in order to manage disposal.
DisposeHandler
& AsyncDisposeHandler
A simple set of classes for triggering an action (once) when disposed. Can also contain a value (T) which is cleared on dispose.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- System.Threading.Tasks.Extensions (>= 4.5.4)
-
.NETStandard 2.1
- No dependencies.
-
net9.0
- No dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Open.Disposable:
Package | Downloads |
---|---|
Open.Disposable.ObjectPools
A set of variations on ObjectPool implementations with differing underlying collections. Part of the "Open" set of libraries. |
GitHub repositories
This package is not used by any popular GitHub repositories.