Skip to content

Revised MissingManifestResourceException for .NET Core, .NET Framework, UWP #2432

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

Merged
merged 1 commit into from
May 10, 2019
Merged

Revised MissingManifestResourceException for .NET Core, .NET Framework, UWP #2432

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
14 changes: 8 additions & 6 deletions xml/System.Resources/MissingManifestResourceException.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,8 +49,9 @@

## Remarks

## Desktop Apps
In desktop apps, <xref:System.Resources.MissingManifestResourceException> is thrown when the attempt to retrieve a resource fails because the resource set for the neutral culture could not be loaded from a particular assembly. Although the exception is thrown when you try to retrieve a particular resource, it is caused by the failure to load the resource set rather than the failure to find the resource.
## .NET apps

In .NET Framework and .NET Core apps, <xref:System.Resources.MissingManifestResourceException> is thrown when the attempt to retrieve a resource fails because the resource set for the neutral culture could not be loaded from a particular assembly. Although the exception is thrown when you try to retrieve a particular resource, it is caused by the failure to load the resource set rather than the failure to find the resource.

> [!NOTE]
> For additional information, see the "Handling a MissingManifestResourceException Exception" section in the <xref:System.Resources.ResourceManager> class topic.
Expand All @@ -77,12 +78,13 @@
> [!NOTE]
> We recommend that you include a neutral set of resources in your main assembly, so your app won't fail if a satellite assembly is unavailable.

## [!INCLUDE[win8_appname_long](~/includes/win8-appname-long-md.md)] Apps
Unlike desktop apps, which deploy localized resources in satellite assemblies and typically store the resources of the neutral culture in the main assembly, [!INCLUDE[win8_appname_long](~/includes/win8-appname-long-md.md)] apps deploy resources for multiple cultures, including the neutral culture, in a single package resource index (.pri) file. As a result, in a [!INCLUDE[win8_appname_long](~/includes/win8-appname-long-md.md)] app, if resources for the preferred culture cannot be found, the <xref:System.Resources.MissingManifestResourceException> is thrown under either of the following conditions:
## Universal Windows Platform (UWP) apps

UWP apps deploy resources for multiple cultures, including the neutral culture, in a single package resource index (.pri) file. As a result, in a UWP app, if resources for the preferred culture cannot be found, the <xref:System.Resources.MissingManifestResourceException> is thrown under either of the following conditions:

- The app does not include a .pri file or the .pri file could not be opened.
- The app does not include a .pri file, or the .pri file could not be opened.

- The app's .pri file does not contain a resource set for the given root name.
- The app's .pri file does not contain a resource set for the given root name.

]]></format>
</remarks>
Expand Down