// Licensed to the .NET Foundation under one or more agreements. // The .NET Foundation licenses this file to you under the Apache 2.0 License. // See the LICENSE file in the project root for more information. using System.Collections.Generic; using System.Diagnostics; using System.Threading; using System.Threading.Tasks; namespace System.Linq { public static partial class AsyncEnumerableEx { public static IAsyncEnumerable Using(Func resourceFactory, Func> enumerableFactory) where TResource : IDisposable { if (resourceFactory == null) throw Error.ArgumentNull(nameof(resourceFactory)); if (enumerableFactory == null) throw Error.ArgumentNull(nameof(enumerableFactory)); return new UsingAsyncIterator(resourceFactory, enumerableFactory); } public static IAsyncEnumerable Using(Func> resourceFactory, Func>> enumerableFactory) where TResource : IDisposable { if (resourceFactory == null) throw Error.ArgumentNull(nameof(resourceFactory)); if (enumerableFactory == null) throw Error.ArgumentNull(nameof(enumerableFactory)); return new UsingAsyncIteratorWithTask(resourceFactory, enumerableFactory); } private sealed class UsingAsyncIterator : AsyncIterator where TResource : IDisposable { private readonly Func> _enumerableFactory; private readonly Func _resourceFactory; private IAsyncEnumerator _enumerator; private TResource _resource; public UsingAsyncIterator(Func resourceFactory, Func> enumerableFactory) { Debug.Assert(resourceFactory != null); Debug.Assert(enumerableFactory != null); _resourceFactory = resourceFactory; _enumerableFactory = enumerableFactory; } public override AsyncIterator Clone() { return new UsingAsyncIterator(_resourceFactory, _enumerableFactory); } public override async ValueTask DisposeAsync() { if (_enumerator != null) { await _enumerator.DisposeAsync().ConfigureAwait(false); _enumerator = null; } if (_resource != null) { _resource.Dispose(); _resource = default; } await base.DisposeAsync().ConfigureAwait(false); } protected override async ValueTask MoveNextCore() { // NB: Earlier behavior of this operator was more eager, causing the resource factory to be called upon calling // GetAsyncEnumerator. This is inconsistent with asynchronous "using" and with a C# 8.0 async iterator with // a using statement inside, so this logic got moved to MoveNextAsync instead. switch (_state) { case AsyncIteratorState.Allocated: _resource = _resourceFactory(); _enumerator = _enumerableFactory(_resource).GetAsyncEnumerator(_cancellationToken); _state = AsyncIteratorState.Iterating; goto case AsyncIteratorState.Iterating; case AsyncIteratorState.Iterating: while (await _enumerator.MoveNextAsync().ConfigureAwait(false)) { _current = _enumerator.Current; return true; } await DisposeAsync().ConfigureAwait(false); break; } return false; } } private sealed class UsingAsyncIteratorWithTask : AsyncIterator where TResource : IDisposable { private readonly Func>> _enumerableFactory; private readonly Func> _resourceFactory; private IAsyncEnumerable _enumerable; private IAsyncEnumerator _enumerator; private TResource _resource; public UsingAsyncIteratorWithTask(Func> resourceFactory, Func>> enumerableFactory) { Debug.Assert(resourceFactory != null); Debug.Assert(enumerableFactory != null); _resourceFactory = resourceFactory; _enumerableFactory = enumerableFactory; } public override AsyncIterator Clone() { return new UsingAsyncIteratorWithTask(_resourceFactory, _enumerableFactory); } public override async ValueTask DisposeAsync() { if (_enumerator != null) { await _enumerator.DisposeAsync().ConfigureAwait(false); _enumerator = null; } if (_resource != null) { _resource.Dispose(); _resource = default; } await base.DisposeAsync().ConfigureAwait(false); } protected override async ValueTask MoveNextCore() { switch (_state) { case AsyncIteratorState.Allocated: _resource = await _resourceFactory().ConfigureAwait(false); _enumerable = await _enumerableFactory(_resource).ConfigureAwait(false); _enumerator = _enumerable.GetAsyncEnumerator(_cancellationToken); _state = AsyncIteratorState.Iterating; goto case AsyncIteratorState.Iterating; case AsyncIteratorState.Iterating: while (await _enumerator.MoveNextAsync().ConfigureAwait(false)) { _current = _enumerator.Current; return true; } await DisposeAsync().ConfigureAwait(false); break; } return false; } } } }