mirror of
https://github.com/nsnail/spectre.console.git
synced 2025-04-16 00:42:51 +08:00
223642b797
* Adding social card infrastructure * Upgrades doc project to .NET 6 * Adds Playwright * Changes the console to a web project for Playwright * Adds social card template * Added blog content * Parallelized social image processing * Updating CI to use .NET 6 for docs build
57 lines
1.8 KiB
Markdown
57 lines
1.8 KiB
Markdown
Title: Exceptions
|
|
Order: 40
|
|
Description: "Exceptions aren't always readable when viewed in the terminal. You can make exception a bit more readable by using the **WriteException** method."
|
|
Highlights:
|
|
- Color coded output.
|
|
- Shorten long identifiers and paths.
|
|
---
|
|
|
|
Exceptions aren't always readable when viewed in the terminal.
|
|
You can make exception a bit more readable by using the `WriteException` method.
|
|
|
|
```csharp
|
|
AnsiConsole.WriteException(ex);
|
|
```
|
|
|
|
<?# AsciiCast cast="default-exception" /?>
|
|
|
|
## Shortening parts
|
|
|
|
You can also shorten specific parts of the exception to make it even
|
|
more readable, and make paths clickable hyperlinks. Whether or not
|
|
the hyperlinks are clickable is up to the terminal.
|
|
|
|
```csharp
|
|
AnsiConsole.WriteException(ex,
|
|
ExceptionFormats.ShortenPaths | ExceptionFormats.ShortenTypes |
|
|
ExceptionFormats.ShortenMethods | ExceptionFormats.ShowLinks);
|
|
```
|
|
|
|
<?# AsciiCast cast="shortened-exception" /?>
|
|
|
|
## Customizing exception output
|
|
|
|
In addition to shorten specific part of the exception, you can
|
|
also override the default styling.
|
|
|
|
```csharp
|
|
AnsiConsole.WriteException(ex, new ExceptionSettings
|
|
{
|
|
Format = ExceptionFormats.ShortenEverything | ExceptionFormats.ShowLinks,
|
|
Style = new ExceptionStyle
|
|
{
|
|
Exception = new Style().Foreground(Color.Grey),
|
|
Message = new Style().Foreground(Color.White),
|
|
NonEmphasized = new Style().Foreground(Color.Cornsilk1),
|
|
Parenthesis = new Style().Foreground(Color.Cornsilk1),
|
|
Method = new Style().Foreground(Color.Red),
|
|
ParameterName = new Style().Foreground(Color.Cornsilk1),
|
|
ParameterType = new Style().Foreground(Color.Red),
|
|
Path = new Style().Foreground(Color.Red),
|
|
LineNumber = new Style().Foreground(Color.Cornsilk1),
|
|
}
|
|
});
|
|
```
|
|
|
|
<?# AsciiCast cast="custom-colors-exception" /?>
|