search

dotnet / reactive

The Reactive Extensions for .NET
http://reactivex.io
MIT License
6.67k stars 747 forks source link

Where is the documentation for System.Linq.Async ? #1097

Open oliverjanik opened 4 years ago

oliverjanik commented 4 years ago

It's wonderful that we now have framework provided IAsyncEnumerable and some C# sugar for it, but where are the extension methods we all need ? Where Select ....

Is this package the official home for IAsyncEnumerable extension methods? If yes, where can I read more about it? Where are the docs?

Why isn't full Linq support included in the .net core framework?

akarnokd commented 4 years ago

where are the extension methods

If yes, where can I read more about it? Where are the docs?

The IAsyncEnumerable is pretty new and since this project is developed outside the C# corefx, we volunteers and contributors had no time yet to add much documentation. The best you can do is search for IAsyncEnumerable online and consider results after this October.

oliverjanik commented 4 years ago

Thanks for clearing things up. I am very grateful for volunteer work.

I'm a little surprised MS has not put its weight behind IAsyncEnumerable.

Do you know if MS has plans to adopt this package into corefx? Or will it always be a 'contrib' ?

akarnokd commented 4 years ago

Do you know if MS has plans to adopt this package into corefx? Or will it always be a 'contrib' ?

I don't know.

zvolkov commented 4 years ago

Googled IAsyncEnumerable (used results since Oct 1st) - nothing about System.Linq.Async. I suppose the best we can do is read the source code of https://github.com/dotnet/reactive/blob/master/Ix.NET/Source/System.Linq.Async/System/Linq/AsyncEnumerable.AsyncOverloads.cs

Bellarmine-Head commented 2 years ago

I didn't get very far in trying to work out how to use System.Linq.Async from looking at the repo, and ended up writing my own simple GetListAsync method using await foreach (and not using the package). I use my GetListAsync for consuming Azure's AsyncPageables.

But these two articles seem to be very useful, especially the second one:-

https://markheath.net/post/async-enumerable-1 https://markheath.net/post/async-enumerable-2

so I may use the System.Linq.Async package next time around.

KyleMit commented 5 months ago

Even a readme as part of the nuget package with a couple of prime examples would be a big step up if this is still on anyone's radar.