Open.Disposable 2.5.2

There is a newer version of this package available.
See the version list below for details.
dotnet add package Open.Disposable --version 2.5.2                
NuGet\Install-Package Open.Disposable -Version 2.5.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Open.Disposable" Version="2.5.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Open.Disposable --version 2.5.2                
#r "nuget: Open.Disposable, 2.5.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Open.Disposable as a Cake Addin
#addin nuget:?package=Open.Disposable&version=2.5.2

// Install Open.Disposable as a Cake Tool
#tool nuget:?package=Open.Disposable&version=2.5.2                

Open.Disposable

Provides a set of useful classes when implementing a disposable.

NuGet

Core principles

  • For most use cases, disposal should only occur once and be final.
  • Implementing IDisposable in combination with IAsyncDisposable 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 a BeforeDispose event which will be triggered once just before disposing commences. This allows for others to react to this disposal event. The DisposableBase is still considered 'live' until after the BeforeDispose 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 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. 
.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.

Version Downloads Last updated
3.0.1 1,029 11/15/2024
3.0.0 220 11/14/2024
2.6.0 40,175 4/19/2022
2.5.2 14,816 8/1/2021
2.4.1 90,385 7/16/2020
2.3.0 38,877 7/4/2019
1.2.1 11,291 7/18/2018