Philiprehberger.Disposer
v0.1.9914 downloadsMIT
Composite disposable container that disposes multiple IDisposable/IAsyncDisposable objects in reverse order.
$
dotnet add package Philiprehberger.DisposerREADME
Philiprehberger.Disposer
Composite disposable container that disposes multiple IDisposable/IAsyncDisposable objects in reverse order.
Installation
dotnet add package Philiprehberger.Disposer
Usage
using Philiprehberger.Disposer;
using var disposer = new Disposer();
var stream = new FileStream("data.bin", FileMode.Open);
disposer.Add(stream);
var reader = new StreamReader(stream);
disposer.Add(reader);
// Add a cleanup delegate
disposer.Add(() => Console.WriteLine("All cleaned up!"));
// When disposer is disposed, items are cleaned up in reverse order:
// 1. Cleanup delegate runs
// 2. reader is disposed
// 3. stream is disposed
Fluent Registration with DisposeWith
using Philiprehberger.Disposer;
using var disposer = new Disposer();
var stream = new FileStream("data.bin", FileMode.Open)
.DisposeWith(disposer);
var reader = new StreamReader(stream)
.DisposeWith(disposer);
Async Disposal
using Philiprehberger.Disposer;
await using var disposer = new Disposer();
var connection = new HttpClient()
.DisposeWith(disposer);
// DisposeAsync is called when the await using block exits
Error Aggregation
All registered items are disposed even if some throw. Exceptions are collected and thrown as a single AggregateException.
API
Disposer
| Member | Description |
|---|---|
Add(params IDisposable[]) | Register one or more disposable objects |
Add(Action) | Register a cleanup delegate |
AddAsync(IAsyncDisposable) | Register an async disposable object |
Count | Number of registered disposables |
Dispose() | Dispose all in reverse order (LIFO) |
DisposeAsync() | Async dispose all in reverse order (LIFO) |
DisposerExtensions
| Method | Description |
|---|---|
DisposeWith<T>(Disposer) | Register an IDisposable and return it for fluent use |
DisposeAsyncWith<T>(Disposer) | Register an IAsyncDisposable and return it for fluent use |
Development
dotnet build src/Philiprehberger.Disposer.csproj --configuration Release
Support
If you find this project useful: