ValueTask documentation - Document behavior when ValueTask.IsFaulted is true

[tom-puckett]

There is no Exception property of ValueTask<T>. It would help to explain in the remarks whether an exception can be caught in the calling code, or is it necessary to test IsFaulted, and if so, how can I discover what the fault is.

[colejohnson66]

ValueTask is designed to hold either the result or a Task. It helps to remember that it is for situations where, most of the time, a result can be provided without asynchronous operations. In other words, to avoid allocations on the "happy path". As such, when a ValueTask is not immediately completed, it actually contains an inner Task that either represents the future or contains the result or exception. In other words, the exception is stored in the inner Task.

The proper way to handle any ValueTask is await it.

[tom-puckett]

Thanks. The request here is to add information to that effect in the documentation page, making it more informative and useful.