Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Exception handling and Glob/Loc in Blazor Hybrid #27702

Merged
merged 7 commits into from
Nov 21, 2022
Merged

Exception handling and Glob/Loc in Blazor Hybrid #27702

Changes from 5 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
9717f5c
Exception handling in WinForms/WPF Blazor apps
guardrex Nov 21, 2022
a6954c3
Updates
guardrex Nov 21, 2022
5e786ac
Updates
guardrex Nov 21, 2022
745b80e
Updates
guardrex Nov 21, 2022
db9ae8c
Updates
guardrex Nov 21, 2022
7b7df21
Update aspnetcore/blazor/hybrid/index.md
guardrex Nov 21, 2022
09a91e7
Updates
guardrex Nov 21, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 42 additions & 1 deletion aspnetcore/blazor/hybrid/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: Explore ASP.NET Core Blazor Hybrid, a way to build interactive clie
monikerRange: '>= aspnetcore-6.0'
ms.author: riande
ms.custom: "mvc"
ms.date: 11/08/2022
ms.date: 11/21/2022
uid: blazor/hybrid/index
---
# ASP.NET Core Blazor Hybrid
Expand Down Expand Up @@ -35,6 +35,47 @@ Blazor Hybrid exposes the underlying Web View configuration for different platfo

Use the preferred patterns on each platform to attach event handlers to the events to execute your custom code.

## Unhandled exceptions in Windows Forms and WPF apps

*This section only applies to Windows Forms and WPF Blazor Hybrid apps.*

Create a callback for `UnhandledException` on the <xref:System.AppDomain.CurrentDomain?displayProperty=fullName> property. The following example uses a [compiler directive](/dotnet/csharp/language-reference/preprocessor-directives/preprocessor-if) to display a <xref:System.Windows.Forms.MessageBox> that either alerts the user that an error has occurred or shows the error information to the developer. Log the error information in `error.ExceptionObject`.

```csharp
AppDomain.CurrentDomain.UnhandledException += (sender, error) =>
{
#if DEBUG
MessageBox.Show(text: error.ExceptionObject.ToString(), caption: "Error");
#else
MessageBox.Show(text: "An error occurred.", caption: "Error");
guardrex marked this conversation as resolved.
Show resolved Hide resolved
#endif

// Log the error information (error.ExceptionObject)
};
```

> [!WARNING]
> Avoid exposing error information to users, which is a security risk.

## Globalization and localization

*This section only applies to .NET MAUI Blazor Hybrid apps.*

.NET MAUI configures the <xref:System.Globalization.CultureInfo.CurrentCulture> and <xref:System.Globalization.CultureInfo.CurrentUICulture> based on the device's ambient information.

<xref:Microsoft.Extensions.Localization.IStringLocalizer> and other API in the <xref:Microsoft.Extensions.Localization?displayProperty=fullName> namespace generally work as expected, along with globalization formatting, parsing, and binding that relies on the user's culture.

When dynamically changing the app culture at runtime, the app must be reloaded to reflect the change in culture, which takes care of rerendering the root component and passing the new culture to rerendered child components.

.NET's resource system supports embedding localized images (as blobs) into an app, but Blazor Hybrid can't display the embedded images in Razor components at this time. Even if a user reads an image's bytes into a <xref:System.IO.Stream> using <xref:System.Resources.ResourceManager>, the framework doesn't currently support rendering the retrieved image in a Razor component.

[A platform-specific approach to include localized images](/xamarin/xamarin-forms/user-interface/images#local-images) is a feature of .NET's resource system, but a Razor component's browser elements in a .NET MAUI Blazor Hybrid app aren't able to interact with such images.

For more information, see the following resources:

* [Xamarin.Forms String and Image Localization](/xamarin/xamarin-forms/app-fundamentals/localization/): The guidance generally applies to Blazor Hybrid apps. Not every scenario is supported at this time.
* [Blazor Image component to display images that are not accessible through HTTP endpoints (dotnet/aspnetcore #25274)](https://github.com/dotnet/aspnetcore/issues/25274)

## Additional resources

* <xref:blazor/hybrid/tutorials/index>
Expand Down