A lightweight library providing extension methods for Task, Task<T>, ValueTask, and ValueTask<T> to simplify asynchronous programming patterns in .NET applications.
Timeout Support: Execute async operations with configurable timeout handling
Multi-Framework Support: Compatible with .NET Standard 2.0, .NET 8.0, .NET 9.0, and .NET 10.0
Lightweight: Minimal dependencies, focused on essential functionality
Modern: Supports both Task and ValueTask patterns
🚀 Usage
WithTimeoutAsync
Execute asynchronous operations with a timeout. Returns true if the operation completes within the specified timeout, false otherwise.
Task with Timeout (milliseconds)
using NetEvolve.Extensions.Tasks;
var task = SomeAsyncOperation();
var completed = await task.WithTimeoutAsync(5000); // 5 seconds timeout
if (completed)
{
Console.WriteLine("Operation completed successfully");
}
else
{
Console.WriteLine("Operation timed out");
}
Task with Timeout (TimeSpan)
using NetEvolve.Extensions.Tasks;
var task = SomeAsyncOperation();
var completed = await task.WithTimeoutAsync(TimeSpan.FromSeconds(5));
if (completed)
{
Console.WriteLine("Operation completed successfully");
}
else
{
Console.WriteLine("Operation timed out");
}
Task<T> with Timeout
using NetEvolve.Extensions.Tasks;
var task = GetDataAsync();
var completed = await task.WithTimeoutAsync(3000);
if (completed)
{
var result = await task; // Safe to await again, already completed
Console.WriteLine($"Result: {result}");
}
else
{
Console.WriteLine("Operation timed out");
}
ValueTask with Timeout
using NetEvolve.Extensions.Tasks;
ValueTask operation = PerformAsyncOperation();
var completed = await operation.WithTimeoutAsync(TimeSpan.FromSeconds(10));
if (!completed)
{
Console.WriteLine("Operation did not complete in time");
}
With CancellationToken
using NetEvolve.Extensions.Tasks;
var cts = new CancellationTokenSource();
var task = LongRunningOperation();
try
{
var completed = await task.WithTimeoutAsync(5000, cts.Token);
if (!completed)
{
Console.WriteLine("Timeout occurred");
}
}
catch (OperationCanceledException)
{
Console.WriteLine("Operation was cancelled");
}
📚 API Reference
Extension Methods
All extension methods are available for:
Task
Task<T>
ValueTask
ValueTask<T>
WithTimeoutAsync(int, CancellationToken)
Waits for a task to complete within the specified timeout in milliseconds.
Parameters:
timeoutInMilliseconds (int): Timeout in milliseconds. Use Timeout.Infinite (-1) to wait indefinitely.
