Files
PowerShell-PowerShell/docs/workflow/resources.md
T

1.2 KiB

Resources

Resources are .resx files with string values that we use for error messages and such. They live in src\<project>\resources folders.

At the moment dotnet cli doesn't support generating C# bindings (strongly typed resource files).

We are using our own Start-ResGen to generate them.

Usually it's called as part of the regular build with

PS C:\> Start-PSBuild -ResGen

If you see compilation errors related to resources, try to call Start-ResGen explicitly.

PS C:\> Start-ResGen

Editing resx files

Don't edit resx files from Visual Studio. It will try to create .cs files for you and you will get whole bunch of hard-to-understand errors.

To edit resource file, use any plain text editor. Resource file is a simple xml, and it's easy to edit.

Convert txt resource files into resx

dotnet cli doesn't support embeeding old-fashioned txt resource. You can do a one-time convertion of .txt resources into .resx files with a helper function

# example, converting all .txt resources under src\Microsoft.WSMan.Management\resources
PS C:\> Convert-TxtResourceToXml -Path src\Microsoft.WSMan.Management\resources

.resx files would be placed next to .txt files.