TryDisposable 8.0.1

TryDisposable

Wrap an object in a disposable decorator to attempt to dispose the object later. This is useful when retrieving an instance of an object from a factory or container while only having an interface reference. If the interface does not implement IDisposable, but the concrete class does, this will allow the instance to be disposed.

##Example 1

Use the simple TryDispose() method available on any object.

object obj = new object();
obj.TryDispose();

##Example 2

Wrap an object in a using statement. Use the instance property to access the object.

ITemporaryFolder tempFolder = TemporaryFolder.Factory.Create();

using (ITryDisposable<ITemporaryFolder> disposableTempFolder = TryDisposableFactory.Create(tempFolder))
{
	string path = disposableTempFolder.Instance.Path;

	// If tempFolder is disposable, it will get disposed, otherwise it will be ignored.
}

##Example 2

Use the following if the underlying object does not need to be accessed through the ITryDisposbale<TUnderlyingItem> interface.

using (ITryDisposable disposableTempFolder = TryDisposableFactory.Create(tempFolder))
{
	// If tempFolder is disposable, it will get disposed, otherwise it will be ignored.
}