StandardResults 1.5.2
dotnet add package StandardResults --version 1.5.2
NuGet\Install-Package StandardResults -Version 1.5.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="StandardResults" Version="1.5.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="StandardResults" Version="1.5.2" />
<PackageReference Include="StandardResults" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add StandardResults --version 1.5.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: StandardResults, 1.5.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package StandardResults@1.5.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=StandardResults&version=1.5.2
#tool nuget:?package=StandardResults&version=1.5.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
StandardResults
Lightweight C# result primitives for functional error handling with support for async operations, validation aggregation, and error collections.
Targets .NET Standard 2.0.
Features
Result<T, TError>type with success/failure flow- Async helpers (
MapAsync,BindAsync,TryAsync, etc.) - Immutable
Error,ErrorCollection, andValidationErrors - Fluent API for error accumulation with conditional methods (
When,Require)
Installation
dotnet add package StandardResults
Documentation
- Result Type Guide - Core Result features, creation, state checking, transformations, and pattern matching
- Extensions and Async Guide - Advanced async operations, extension methods, and async patterns
- Validation Guide - Error handling, validation patterns, and error aggregation
Usage
Basic Result
using StandardResults;
Result<int, Error> Divide(int a, int b)
{
if (b == 0)
return Result<int, Error>.Failure(Error.Permanent("divide_by_zero", "Division by zero"));
return Result<int, Error>.Success(a / b);
}
var result = Divide(10, 2);
if (result.IsSuccess)
{
Console.WriteLine($"Value = {result.Value}");
}
else
{
Console.WriteLine($"Error = {result.Error}");
}
Mapping and Binding
var r1 = Result<int, Error>.Success(5);
var r2 = r1.Map(x => x * 2); // Success(10)
var r3 = r1.Bind(x => Divide(x, 0)); // Failure(Error)
Async Helpers
var r = await Result.TryAsync(
async () => await Task.FromResult(42),
ex => Error.Transient("exception", ex.Message)
);
var mapped = await r.MapAsync(x => Task.FromResult(x * 2));
Error Collection
var errors = ErrorCollection.Empty
.WithError("not_found", "User not found")
.WithError("timeout", "Service unavailable", transient: true);
Console.WriteLine(errors.Summary()); // "not_found: User not found; timeout: Service unavailable"
Validation Errors
var validation = ValidationErrors.Empty
.RequireNotEmpty(username, "username")
.Require(password?.Length >= 6, "password", "Password must be at least 6 characters");
if (validation.HasErrors)
{
Console.WriteLine(validation.Summary());
}
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- System.Collections.Immutable (>= 6.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.