DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI
2025.0.1-rc-243301701
See the version list below for details.
dotnet add package DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI --version 2025.0.1-rc-243301701
NuGet\Install-Package DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI -Version 2025.0.1-rc-243301701
<PackageReference Include="DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI" Version="2025.0.1-rc-243301701" />
paket add DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI --version 2025.0.1-rc-243301701
#r "nuget: DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI, 2025.0.1-rc-243301701"
// Install DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI as a Cake Addin #addin nuget:?package=DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI&version=2025.0.1-rc-243301701&prerelease // Install DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI as a Cake Tool #tool nuget:?package=DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI&version=2025.0.1-rc-243301701&prerelease
UI for ASP.NET Core Problem Result Extension
© 2024 DotNet Brightener
Introduction
This is an extensions for ASP.Net Core applications that use the ProblemResult package. This package provides a UI for viewing information about a specific error / exception that can be thrown by the application.
Check out the ProblemResult package for more details on how to implement self-documented error objects.
Installation
You can install the package from NuGet:
dotnet add package DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult.UI
Enable UI for viewing errors information
1. Enable generate XML documentation file in your projects / solutions.
Add the following code to the section <PropertyGroup>
in your your .csproj
file:
<GenerateDocumentationFile>true</GenerateDocumentationFile>
If you have multiple projects in your solution, you'll need to add the above code to all of the projects. Another way is to add that to the Directory.Build.props
file in the root of your solution.
2. Configure the ASP.Net project to use the UI package.
Add the following code to your Startup.cs
(if you use Startup.cs) or Program.cs
(by default) file:
app.MapErrorDocsTrackerUI(options =>
{
options.UiPath = "/errors-info-ui"; // this is where you can access the UI from your application
options.ApplicationName = "Test Error"; // this is the name of your application
});
How this work?
When your application is configured to use UI package, the application will collect the error classes that are derived from IProblemResult
. The error object when returned from the application, will now have type
properties that leads to the information page of the error.
{
"type": "https://localhost:7290/errors-info-ui#/WebAppCommonShared.Demo.Controllers.UserNotFoundError",
"title": "User Not Found Error",
"status": 404,
"detail": "The error is thrown because the requested resource of type User could not be found",
"instance": "/api/ExceptionTest/exception2/123",
"data": {
"userId": 123
}
}
If developer / user opens the Url found in type
property, they'll be able to see the information about the error. With the provided information, the developer can identify the issue and fix the issue easier. For the user, they can use this to seek support from developer.
Example
Given the error object defined as below:
/// <summary>
/// The error represents the requested object of type `User` could not be found
/// </summary>
/// <remarks>
/// The error is thrown because the requested resource of type `User` could not be found
/// </remarks>
public class UserNotFoundError : BaseProblemDetailsError
{
public UserNotFoundError()
: base(HttpStatusCode.NotFound)
{
}
public UserNotFoundError(long userId)
: this()
{
Data.Add("userId", userId);
}
}
visiting the URL in type
property will see an error page like following:
User Not Found Error
Description
The error represents the requested object of type
User
could not be foundReason
The error is thrown because the requested resource of type
User
could not be foundResponse HTTP Status Code
The request that encounters this error shall be responded with HTTP Status Code 404.
Additionally, refer to RFC 9110 Document Specification for Status Code 404.
Response Body
Below is the sample response body of the request that encounters this error. Depends on the error, there can be additional properties that help you identify the issue.
{ "type": "https://localhost:7290/errors#WebAppCommonShared.Demo.Controllers.UserNotFoundError", "title": "User Not Found Error", "status": 404, "detail": "The error is thrown because the requested resource of type User could not be> >found", "instance": "{usually is URL of the request}" }
The Description
of the page is pulled from XML Document <summary>
tag, and the Reason
is pulled from <remarks>
tag. The Response HTTP Status Code
is the status code that the error object is associated with. The Response Body
is the sample response body that the error object will be returned.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net9.0 is compatible. |
-
net9.0
- DotNetBrightener.AspNet.Extensions.SelfDocumentedProblemResult (>= 2025.0.1-rc-243301701)
- Newtonsoft.Json (>= 13.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.